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PMvOget read a pixel from buffer PMvOget(3X) 

PMvOput write a pixel to buffer PMvOput(3X) 

PMvlget read a pixel from buffer 1 PMv(3X) 

PMvlput write a pixel to buffer 1 PMv(3X) 

PMcopyJ fast but dangerous 32 bit DAHf^M copy ! PMcopy_f(3X) 

increments PMcopy_v 32-bit copy with variable PMcopy_v(3X) 

PMcopy_s safe 32-bit DRAM or VRAM copy PMcopy_s(3X) 

PMnorm normalize a 3D vector and retum its length PMnonn(3M) 

manipulate page registers used to access video and Z memory /to PMpagereg(3X) 

Aoad a page register and retum an address to a section of DRAM PMgetzaddr(3X) 

PMgetzdesc, PMzdescjvalid allocate a DRAM block PMgetzdesc(3X) 

DRAM and page registers for dynamic allocaticMi /PMset_hireg reserve PMzbrk(3X) 

DEVswap_pipe switch primary and altemate pipes of a dual pipe/ DEVswap__pipe(3H) 

to compute the cosine of an angle PMcos trigonometric function PMcos(3M) 

PMapply apply a function to all subscreens PMapply(3X) 

PMlong_dsp convert an array of longs to float PMlong_dsp(3M) 

d3as DSP32 assembler d3as(l) 

/DEVopen_system make a Pixel machine available to a user program DEVopen(3S) 

pucel nodes DEVnm begin execution of aU pipe and DEVrun(3H) 

into specified pipe/ DEVpipe_run begin execution of programs loaded DEVpipe_run(3S) 

into specified pixel/ DEVpixel_run begin execution of programs loaded DEVpixel_run(3S) 

PMcopyJ fast but dangerous 32 bit D/VRAM copy PMcopy_f(3X) 

PMzdesc_valid allocate a DRAM block PMgetzdesc, PMgetzdesc(3X) 

iaterleave or deinterleave a block PMinterleave PMinterleave(3X) 

register DEVpipe_put write a block of data to a pipe DSP*s PDR DEVpipe_put(3S) 

register DEVpbLel_put send a block of data to a pixel DSP's PDR DEVpixel_put(3S) 

pipe feedback/ DEVfifo_read read a block of four byte values from a DEVfifo_read(3S) 

FIFO DEVfifo_write write a block of four byte values to a pipe DEVfifo_write(3S) 

DEVpipe_read reads a block of memory from a pipe DSP DEVpipe_read(3S) 

DEVpixel_read read a block of memory from a pixel DSP DEVpbcel_read(3S) 

DEVpLxel__id_write write a node id block to a reserved location in a/ DEVpixel_id_write(3S) 

PMcopyvtov copy blocks of VRAM PMcopyvtov(3X) 

resets all FIFOs on a pipe board DEVfifo_reset DEVfifo_reset(3S) 

color tables from video controller board and retum the value /update DEVput_color_map(3S) 

color tables from video controller board and retums value /read the DEVget_color_map(3S) 

DEVpixel_mode_init initialize pixel board mode register DEVpixel_mode_init(3S) 

DEVfifo_paraIlel configure a pipe board to operate in parallel mode DEVfifo__parallel(3S) 

DEVfifo_serial configure a pipe board to operate in serial mode DEVfifo_serial(3S) 

/wait until control of the broadcast bus is granted PMswap_pipe(3H) 

read a pixel from the frame buffer DEVget_pixel, DEVget_pixels DEVget_pixel(3S) 

one or more scan lines from a frame buffer DEVget_scan_line read DEVget_scan_line(3H) 

write pixels into the frame buffer DEVput_pixel, DEVput_pixels DEVput_pixel(3S) 

read a pixel from the current buffer PMgetpix PMgetpix(3X) 

read a float value from the Z buffer PMgetzbuf , PMgetzbuf(3X) 

output a pixel to the current buffer PMputpix PMputpix(3X) 

write a float value to the Z buffer PMputzbuf PMputzbuf(3X) 

read of a pixel from the current buffer PMqget quick PMqget(3X) 

write of a pixel to the current buffer PMqput quick PMqput(3X) 

PMswapback swap meaning of back buffer PMswapback(3) 

PMzget read a float frcrni the z buffer PMzget(3X) 

PMvOget read a pixel from buffer PMvOget(3X) 

PMvOput write a pixel to buffer PMvOput(3X) 
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PMvlget read a pixel from 

PMvlput write a pixel to 

of a pixel node DEVread_z read a 

of a pixel/ DEVwrite_z writes a 

DEVpipe_write write a 

DEVpixel_write write a 

DEVpixel_biiffer selects the frame 

PMdblbuff enable double 

PMsnglbuff disable double 

swap front and back pixel 

wait until control of the broadcast 

DEVfifo_read read a block of four 

DEVfifo_write write a block of four 

DEVpixel_get read a stream of 

DEVpipe_get read a stream of 

node DEVread_z read a buffer of 

node DEVwrite_z writes a buffer of 

programs using DEVtools devcc 

d3cc DSP32 

lookup tables /reads file of gamma 

nodes to signal completion, then 

code and specify functions to be 

DEVpipe_id_check 

DEVpixel_id__check 

PMwaitsem wait for semaphore to 

memory/ /DEVrelease__pixel_semaphore 

DEVexit halts processors, 

DEVclose 

DEVuser_msg_enable define a message 

/server program for Pixel Machine 

gamma calibration values and sets 

DEVshadow_off turns off updating of 

DEVshadow_Qn tums on updating of 

board and/ DEVput_color_map update 

board/ DEVget_color_map read the 

floating point value to intemal 

converts an integer to an intemal 

/macro that converts intemal 

/macro that converts intemal 

generate a ZRAM pointer to a 

PMgetcmd load 

data structure used for FIFO 

data structure used for FIFO 

processing of selected system 

/Pixel Machines pipelines and read 

PMfb_on direct output 

d3cc DSP32 C language 

using DEVtools devcc C 

/to the host that signals the 

/wait for pixel nodes to signal 

PMcos trigonometric function to 

in parallel mode DEVfifo_parallel 



buffer 1 PMv(3X) 

buffer 1 PMv(3X) 

buffer of bytes from the Z memory DEVread_z(3S) 

buffer of bytes into the Z memory DEVwrite_z(3S) 

buffer to a pipe DSP DEVpipe_write(3S) 

buffer to a pixel DSP '. DEVpixel_write(3S) 

buffer to be displayed DEVpixel_buffer(3S) 

buffering mode PMdblbuff(3X) 

buffering mode PMsnglbuff(3X) 

buffers PMswapbuff PMswapbuff(3X) 

bus is granted PMswapjpipe PMswap_pipe(3H) 

byte values from a pipe feedback/ DEVfifo_read(3S) 

byte values to a pipe FIFO DEVfifo_write(3S) 

bytes from a pixel DSP's PIR/ DEVpb[el_^gel(3S) 

bytes from the PIR of a pipe DSP DEVpipe_get(3S) 

bytes from the Z memory of a pixel DEVread_z(3S) 

bytes into the Z memory of a pixel DEVwrite_z(3S) 

C compiler for Pixel Machine devcc(l) 

C language compiler d3cc(l) 

calibration values and sets color DEVload_color_tables(3S) 

call DEVexit /wait for pixel DEVwait_exit(3H) 

called /define a message DEVuser_msg_enable(3H) 

check status of node's ID DEVpipejld_check(3S) 

check status of node's ID DEVpixel_id_check(3S) 

clear PMwaitsem(3N) 

clear the software semaphore in the DEVreleasej)ipe_semaphore(3H) 

closes Pixel Machine device DEVexit(3H) 

closes the Pixel Machine DEVclose(3S) 

code and spedfy functions to be/ DEVuserjmsg_enable(3H) 

code that uses the print routines devprint(l) 

color lookup tables /reads file of DEVload_color_tables(3S) 

color lodcup tables from shadow/ DEVshadow_off(3S) 

color lookup tables from shadow/ DEVshadow_on(3S) 

color tables from video controller DEVputjcolor_map(3S) 

color tables from video controller DEVget_color_map(3S) 

color value /macro that converts PMfloat_color(3N) 

color value PMint_color macro that PMint_color(3N) 

color value to an integer PMcolor_int(3N) 

color value to floating point/ PMcolor_float(3N) 

column PMzaddrcol PMzaddrcol(3X) 

command from a pixel node FIFO PMgetcmd(3X) 

commands PMcommand PMcommand(4N) 

commands PMcommand PMcommand(4N) 

commands PMenable enable PMenable(3N) 

commands back from the feedback/ DEVwrite(3H) 

commands to the regular output FIFO PMfb_on(3P) 

compiler d3cc(l) 

compiler for Pixel Machine programs devcc(l) 

completion of a Pixel Machine/ PMhost_exit(3N) 

completion, then call DEVexit DEVwait_exit(3H) 

compute the cosine of an angle PMcos(3M) 

configure a pipe board to operate DEVfifo_paraIlel(3S) 
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in serial mode DEVfifo_serial 

granted PMswap_pipe wait until 

/update color tables from video 

/read the color tables from video 

printf fomiatted output 

PMlong_dsp 

and host long integer DEVbswapl 

and host long integer DEVsswapl 

and host short integer DEVbswaps 

host long integers DEVswap_long 

to host short/ DEVswap_short 

floating-point format/ DEVdsp_ieee 

floating-point format/ DEVieee_dsp 

PMieee_dsp 

color value PMint_color macro that 

intemal/ PMfloat_color macro that 

integer PMcolor_int macro that 

floating/ PMcolor_float macro that 

PMmyx test if a given screen space 

PMmyy test if a given screen space 

PMxat map subscreen 

PMyat map subscreen 

fast but dangerous 32 bit D/VRAM 

PMcopy_s safe 32- bit DRAM or VRAM 

PMcopyvtov 

another PMcopyztoz 

another PMqcopyztoz 

PMcopyftob 

data from input to/ PMcopycmd 

PMcopyvtoz 

PMcopy_v 32- bit 

function to compute the 

PMcopycmd copy opcode, parameter 

PMputcmd write opcode, parameter 

PMgetop get opcode and parameter 

PMputop write opcode and parameter 

PMgetpix read a pixel from the 

PMputpix output a pixel to the 

quick read of a pixel from the 

quick write of a pixel to the 



PMcopy_f fast but 

PMgetdata get 

/copy opcode, parameter count, and 

PMmsg_exchange send and receive 

conmiands PMconmiand 

conmiands PMcommand 

DEVpipe_put write a block of 



configure a pipe board to operate DEVfifo_serial(3S) 

control of the broadcast bus is PMswapjpipe(3H) 

controller board and return the/ DEVput_color_map(3S) 

controller board and retums value DEVget_color_map(3S) 

conversion on host printf(3N) 

convert an array of longs to float PMlong__dsp(3M) 

convert between DSP32 long integer DEVbswapl(3S) 

convert between DSP32 long integer DEVsswapl(3S) 

convert between DSP32 short integer DEVbswaps(3S) 

convert from DSP32 long integers to DEVswapJong(3S) 

convert from DSP32 short integers DEVswap_short(3S) 

convert from the DSP32 DEVdsp_ieee(3S) 

convert from the host's DEVieee_dsp(3S) 

convert IEEE float to DSP float PMieee_dsp(3M) 

converts an integer to an intemal PMint_color(3N) 

converts floating point value to PMfloat_color(3N) 

converts intemal color value to an PMcolor_int(3N) 

converts intemal color value to PMcolor_floal(3N) 

coordinate is in processor space PMmyx(3X) 

coordinate is in processor space PMmyy(3X) 

coordinates to screen space PMxat(3X) 

coordinates to screen space PMyat(3X) 

copy PMcopy_f PMcopy_f(3X) 

copy PMcopy_s(3X) 

copy blocks of VRAM PMcopyvtov(3X) 

copy DRAM to video RAM (3X) 

copy from one section of DRAM to PMcopyztoz(3X) 

copy from one section of DRAM to PMqcopyztoz(3X) 

copy front to back PMcopyftob(3X) 

copy opcode, parameter count, and PMcopycmd(3P) 

copy video RAM to DRAM PMcopyvtoz(3X) 

copy with variable increments PMcopy_v(3X) 

cosine of an angle /trigonometric PMcos(3M) 

count, and data from input to/ PMcopycmd(3P) 

count, and parameters to the output/ PMputcmd(3P) 

count from input FIFO of a pipe/ PMgetop(3P) 

count to the output FIFO of a pipe/ PMputop(3P) 

current buffer PMgetpix(3X) 

current buffer PMputpix(3X) 

current buffer PMqget PMqget(3X) 

current buffer PMqput PMqput(3X) 

d3as DSP32 assembler d3as(l) 

d3cc DSP32 C language compiler d3cc(l) 

d31d DSP32 link editor d31d(l) 

d3sim DSP32 link editor ..-. d3sim(l) 

dangerous 32 bit D/VRAM copy PMcopyJ(3X) 

data from a pipe node FIFO PMgetdata(3P) 

data from input to output FIFO of a/ PMcopycmd(3P) 

data packet over serial Hnks PMmsg_exchange(3X) 

data stracture used for FIFO PMcommand(4N) 

data stracture used for FIFO PMconmiand(4N) 

data to a pipe DSP's PDR register DEVpipe_put(3S) 
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DEVpixel_put send a block of 

register PMfreezaddr 

functions to be/ DEVuser_msg_enable 

PMinterleave interleave or 

Icmg integer and host long integer 

short integer and host short/ 

programs using DEVtools 

macros/ /DEVcwriten, DEVwrite_alt, 

DEVwrite_alt, DEVcready DEVwrite, 

DEV write, DEVcwrite, DEVwriten, 

file to a Pixel Machine 

floating-point format to the IEEE/ 

on standard error 

to signal completion, then call 

Pixel Machine device 

board to operate in parallel mode 

byte values frc«n a pipe feedback/ 

pipe board 

board to operate in serial mode 

byte values to a pipe FIFO 

tables from video controller board/ 

Machine image header from a file 

pixel from the frame buffer 

frame buffer DEVgetjpixel, 

scan lines from a frame buffer 

processors, closes Pixel Machine 

opens and initializes Pixel Machine 

floating-point format to the/ 

DEVtools image file 

DEVtools image file 

Machine device 

DEVpixel_system DEVpipe_nodes, 

/DEVlast_pipe, DEVpixeljiodes, 

gamma calibration values and sets/ 

/DEVx_screen, DEVy_screen, 

Pixel machine available to a user/ 

available to a user/ DEVopen, 

executable into specified set of/ 

from tiie PIR of a pipe DSP 

the PIR of a pipe DSP 

register of a pipe DSP 

processor 

node*s ID 

node ID of a processor 

DEVpixel_nodes,/ DEVpixel__system 

to a pipe DSP's PDR register 

memory from a pipe DSP 

programs loaded into specified/ 

pipe DSP 

executable into specified set of/ 



data to a pixel DSP's PDR register DEVpixel_put(3S) 

decrement references to a page PMfreezaddr(3X) 

define a message code and specify DEVuser_msg_enable(3H) 

deinterleave a block PMinterleave(3X) 

DEVbswapl convert between DSP32 DEVbswapl(3S) 

DEVbswaps convert between DSP32 DEVbswaps(3S) 

devcc C compiler for Pixel Machine devcc(l) 

DEVclose closes the Pixel Machine DEVclose(3S) 

DEVcread, DEVreadn, DEVreadn_alt, DEVwrite(3H) 

DEVcwrite, DEVwriten, DEVcwriten, DEVwrite(3H) 

DEVcwriten, DEVwrite_alt, DEVcready DEVwrite(3H) 

devdisp download an image from a devdisp(l) 

DEVdspJeee convert from the DSP32 DEVdsp_ieee(3S) 

DEVerror generate an error message DEVerror(3S) 

DEVexit /wait for pixel nodes DEVwait_exit(3H) 

DEVexit halts processors, closes DEVexit(3H) 

DEVfifojparaUel configure a pipe ,. DEVfifojparaUel(3S) 

DEVfifo_read read a block of four DEVfifo_read(3S) 

DEVfifo_reset resets all FIFOs on a , DEVfifo_reset(3S) 

DEVfifo_serial configure a pipe DEVfifo_serial(3S) 

DEVfifo^write write a block of four DEVfifo_write(3S) 

DEVget_color_map read the color , DEVget_color_map(3S) 

DEVget_image_header read the Pixel DEVget_image_header(3S) 

DEVgetjpixel, DEVget_pixels read a DEVget_pixel(3S) 

DEVgetjpixels read a pixel from the DEVget_pixel(3S) 

DEVget_scan_line read one or more DEVget_scan_line(3H) 

device DEVexit halts DEVexit(3H) 

device DEVinit DEVinit(3H) 

DEVieee_dsp convert from the host's DEVieee_dsp(3S) 

DEVimage_header format of a , DEVimage_header(4) 

DEVimage_header format of a DEVimage_header(4) 

DEVinit opens and initializes Pixel DEVinit(3H) 

DEVlastjnpe, DEVpixel_nodes,/ DEVpixel_system(3S) 

DEVlastjnxel, DEVxjiodesy DEVpixel_system(3S) 

DEVload_color_tables reads file of DEVload_color_tables(3S) 

DEVlock manage Pbcel Machine locks DEVlock(3S) 

DEVmodelcode, DEVvideocode, DEVpixel_system(3S) 

DEVopen, DEVopen_system make a DEVopen(3S) 

DEVopen_system make a Pixel machine DEVopen(3S) 

DEVpipe_boot load a Pixel Machine DEVpipe_boot(3S) 

DEVpipe_get read a stream of bytes DEVpipe_get(3S) 

DEVpipe_get_msg read a message from DEVpipe_get_msg(3S) 

DEVpipe_getj)ir read the PIR DEVpipe_getj5ir(3S) 

DEVpipe_halt halt a pipe node DEVpipe_halt(3S) 

DEVpipe_id_check check status of DEVpipe_id_check(3S) 

DEVpipe_idjprint read and primt the DEVpipe_id_print(3S) 

DEVpipe_nodes, DEVlast_pipe, DEVpixel_system(3S) 

DEVpipe_put write a block of data DEVpipe_put(3S) 

DEVpipe_read reads a block of DEVpipe_read(3S) 

DEVpipe_mn begin execution of DEVpipe_ran(3S) 

DEVpipe_write write a buffer to a DEVpipe_write(3S) 

DEVpixel_boot load a Pixel Machine DEVpixel_boot(3S) 



C 



DEVtools Reference Manual 



c 



Permuted Index 



buffer to be displayed 

from a pixel DSP*s PIR register 

from a pixel DSP's PIR register 

register of a pixel DSP 

processor 

node's ID 

the node ID of a processor 

block to a reserved location in a/ 

board mode register 

mode in the pixel mode register 

/DEVpipejiodes, DEVlastjpipe, 

mode in aU pixel processor's flag/ 

to a pixel DSP's PDR register 

memory from a pixel DSP 

programs loaded into specified/ 

DEVlast_j3ipe, DEVpixel_nodes,/ 

pixel DSP 

for messages 

Pixel Machine code that uses the/ 

tables from video controller board/ 

Machine image header to a file 

pixels into the frame buffer 

frame buffer DEVputjpixel, 

or a portion of an image to a/ 

/DEVcwriten, DEVwrite_alt. DEVcread, 

/DEVwrite^alt. DEVcread. DEVreadn, 

from the Z memory of a pixel node 

DEVrelease_pixel_semaphore dear/ 

the/ DEVrelease__pipe_semaphore, 

and pixel nodes 

Pixel Machine to a file 

serial I/O link direction 

color lodcup tables from shadow/ 

color lodcup tables from shadow/ 

long integer and host long integer 

long integers to host long/ 

altemate pipes of a dual pipe/ 

short integers to host short/ 

for Pixel Machine programs using 

DEVimage_header format of a 

DEVimageJieader fomiat of a 

code and specify functions to be/ 

DEVy_screen, DEVmodel_code, 

to signal completion, then caU/ 

DEVcwriten, DEVwrite_alty 

/DEVcwrite, DEVwriten, DEVcwriten, 

DEVwrite_alty DEVwrite, DEVcwrite, 

into the Z memory of a pixel node 

/DEVpixel_nodes, DEVlastjpixel, 

/DEVx_nodes, DEVy_nodes, 

/DEVy_nodes, DEVx_scale, DEVy_scale, 

/DEVlast_pixel, DEVx_nodes. 



DEVpixel_buffer selects the frame DEVpixel__buffer(3S: 

DEVpixel_get read a stream of bytes DEVpixel_get(3S 

DEVpixel^et_msg read a message DEVpixel_get_msg(3S 

DEVpixel_getj5ir read the PIR DEVpixel_get_pir(3S; 

DEVpixel_halt halt a pixel node DEVpixel_halt(3S 

DEVpixel_id_check check status of DEVpixel_id_check(3S 

DEVpixel_id_print read and print DEVpixel_id_print(3S; 

DEVpixel_id_write write a node id DEVpixel_id_write(3S; 

DEVpixel_mode_init initialize pixel DEVpixel_mode_init(3S 

DEVpixel_mode_overlay set overlay DEVpixel_mode_overlay(3S 

DEVpixel_nodes, DEVlast_pixeiy DEVpixel_system(3S; 

DEVpixel_overlay update overlay DEVpLxel_overiay(3S] 

DEVpixel_put send a block of data DEVpixel_put(3S] 

DEVpixel_read read a block of DEVpixel_read(3S; 

DEVpixel_run begin execution of DEVpixel_run(3S 

DEVpixel_system DEVpipe_nodes, DEVpixel_system(3S; 

DEVpixel_write write a buffer to a DEVpixel_write(3S 

DEVpoll_nodes poll DSP processors DEVpoU_nodes(3H; 

devprint a host server program for devprint(l 

DEVput_color_map update color DEVput_color_map(3S 

DEVput_image_header write a Pixel DEVput__image_header(3S] 

DEVput_pixel, DEVput_pixels write DEVput_pixel(3S 

DEVputjpixels write pixels into the DEVput_pixel(3S^ 

DEVput_scan_line download an image DEVput__scan_line(3H' 

DEVreadn, DEVreadn_alt, macros to/ DEVwrite(3H; 

DEVreadn^alt, macros to write to/ DEVwrite(3H 

DEVreadz read a buffer of bytes DEVread_z(3S; 

DEVreleasejpipe_semaphore, DEVrelease_pipe_semaphore(3H" 

DEVreleasej3ixel_semaphore clear DEVrelease_pipe_semaphore(3H' 

DEVrun begin execution of all pipe DEVrun(3H' 

devsave upload an image from a devsave(l 

DEVserial_direction updates the DEVserial_direction(3S 

DEVshadow_off tums off updating of DEVshadow_off(3S; 

DEVshadow_on tums on updating of DEVshadow_on(3S] 

DEVsswapl convert between DSP32 DEVsswapl(3S; 

DEVswapJong convert from DSP32 DEVswap_long(3S; 

DEVswap_pipe switch primary and DEVswap_pipe(3H; 

DEVswap_short convert from DSP32 DEVswap_short(3S; 

DEVtools devcc C compiler devcc(l 

DEVtools image file DEVimage_header(4] 

DEVtools image file DEVimage_header(4 

DEVuser_msg_enable define a message DEVuser_msg_enable(3H; 

DEVvideo_code, /DEVx_screen, DEVpixel_system(3S; 

DEVwait_exit wait for pixel nodes DEVwait_exit(3H' 

DEVwrite, DEVcwrite, DEVwriten, DEVwrite(3H; 

DEVwrite_alt, DEVcread, DEVreadn,/ DEVwrite(3H; 

DEVwriten, DEVcwriten, DEVwrite(3H; 

DEVwrite_z writes a buffer of bytes DEVwrite_z(3S 

DEVxnodes. DEVynodes, DEVxscaley DEVpixel_system(3S; 

DEVx_scale, DEVy_scale,/ DEVpixel_system(3S 

DEVx_screen, DEVy_screen,/ DEVpixel_8ystem(3S 

DEVy_nodes, DEVx_scale, DEVy_scale,/ DEVpixel_system(3S 
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/DEVx_nodes, DEVy_nodes, DEVx__scale, 

/DEVy_scale, DEVx_screen, 

regular output FIFO PMfb_on 

updates the serial I/O link 

PMsiodir set serial I/O Unk 

PMsnglbuff 

selects the frame buffer to be 

PMfdiv perfomi floating point 

PMmsg_setup set serial 

PMldot specialized 

PMdblbuff enable 

PMsnglbuff disable 

Pixel Machine devdisp 

an image to a/ DEVput_scan_line 

PMcopyvtoz copy video RAM to 

return an address to a section of 

/PMset_lowreg, PMset_hireg reserve 

PMzdesc_valid allocate a 

PMcopy_s safe 32- bit 

PMcopyztoz copy from one section of 

copy from one section of 

copy 

of bytes from the PIR of a pipe 

a message from the PIR of a pipe 

read the PIR register of a pipe 

reads a block of memory from a pipe 

write a buffer to a pipe 

read the PIR register of a pixel 

read a block of memory from a pixel 

write a buffer to a pixel 

PMieee_dsp convert IEEE float to 

in the memory of one of the 

DEVpoll_nodes poU 

d3as 

d3cc 

floating-point format to the 

IEEE/ DEVdspJeee convert from the 

dSld 

dSsim 

integer DEVbswapl convert between 

integer DEVsswapl convert between 

integers DEVswap_long convert from 

integer DEVbswaps convert between 

DEVswap_short ccmvert from 

a reserved location in a pixel node 

write a block of data to a pipe 

send a block of data to a pixel 

read a stream of b5^es from a pixel 

/read a message from a pixel 

primary and altemate pipes of a 

PMcopy_f fast but dangerous 32 bit 

reserve DRAM and page registers for 



DEVy^scale, DEVx_screeny DEVpixel_system(3S) 

DEVy_screen, DEVmodel_code,/ DEVpixel_system(3S) 

direct output conmiands to the PMfb_on(3P) 

direction DEVserial_direction DEVserial_directiQn(3S) 

direction PMsiodir(3X) 

disable double buffering mode PMsnglbuff(3X) 

displayed DEVpixel_buffer DEVpixel_buffer(3S) 

division PMfdiv(3M) 

DMA input pointer PMmsg_setup(3X) 

dot product for light sources PMldot(3M) 

double buffering mode , PMdblbuff(3X) 

double buffering mode PMsnglbuff(3X) 

download an image from a file to a devdisp(l) 

download an image or a portion of DEVput_scan_line(3H) 

DRAM PMcopyvtoz(3X) 

DRAM Aoad a page register and PMgetzaddr(3X) 

DRAM and page registers for dynamic/ PMzbik(3X) 

DRAM block PMgetzdesc PMgetzdesc(3X) 

DRAM or VRAM copy PMcopy_s(3X) 

DRAM to another , PMcq)yztoz(3X) 

DRAM to another PMqcopyztoz PMqcopyztoz(3X) 

DRAM to video RAM (3X) 

DSP DEVpipe_get read a stream DEVpipe_get(3S) 

DSP DEVpipe_get_msg read DEVpipe__get_msg(3S) 

DSP DEVpipe_get_pir DEVpipe_get_pir(3S) 

DSP DEVpipe_read DEVpipe__read(3S) 

DSP DEVpipe^write DEVpipe_write(3S) 

DSP DEVpixel_get_pir DEVpixel_getjpir(3S) 

DSP DEVpixel_read DEVpixel_read(3S) 

DSP DEVpixel_write DEVpixel_write(3S) 

DSP float i PMieee_dsp(3M) 

DSP processors /software semaphore DEVreleasejpipe_semaphore(3H) 

DSP processors for messages DEVpoIl_nodes(3H) 

DSP32 assembler d3as(l) 

DSP32 C language compiler d3cc(l) 

DSP32 floating point fomiat /host's DEVieee_dsp(3S) 

DSP32 floating-point format to the DEVdsp_ieee(3S) 

DSP32 hnk editor d31d(l) 

DSP32 link editor d3sim(l) 

DSP32 long integer and host long DEVbswapl(3S) 

DSP32 long integer and host long DEVsswapl(3S) 

DSP32 long integers to host long DEVswap_long(3S) 

DSP32 short integer and host short DEVbswaps(3S) 

DSP32 short integers to host short/ DEVswap_short(3S) 

DSP's memory /a node id block to DEVpixel_id_write(3S) 

DSP's PDR register DEVpipejJut DEVpipej)ut(3S) 

DSP's PDR register DEVpixeljput DEVpixel_put(3S) 

DSP's PIR register DEVpixel_get DEVpixel_get(3S) 

DSP's PIR register DEVpixel_get_msg(3S) 

dual pipe system /switch DEVswap_pipe(3H) 

D/VRAM copy PMcopy_f(3X) 

dynamic allocation /PMset_hireg PMzbik(3X) 
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d31d DSP32 link 

d3sim DSP32 link 

PMdblbuff 

system commands PMenable 

an error message on standard 

DEVerror generate an 

DEVpipe_boot load a Pixel Machine 

DEVpixel_boot load a Pixel Machine 

nodes DEVnm begin 

specified pipe/ DEVpipe_nin begin 

specified pixel/ DEVpixel_run begin 

copy PMcopy_f 

of four byte values from a pipe 

and read commands back from the 

PMflagled tum the 

PMrdyled turn the 

byte values from a pipe feedback 

block of four byte values to a pipe 

commands back from the feedback 

commands to the regular output 

load command from a pixel node 

PMgetdata get data from a pipe node 

PMcommand data structure used for 

PMcommand data structure used for 

and data from input to output 

and parameter count from input 

count, and parameters to the output 

write parameters to the output 

and parameter count to the output 

DEVfifo_reset resets ail 

Pixel Machine Image header from a 

format of a DEVtools image 

format of a DEVtools image 

a Pixel Machine image header to a 

an image from a Pixel Machine to a 

and/ DEVIoad_color_tables reads 

devdisp download an image from a 

screen PMclear 

mode in all pixel processor's 

convert IEEE float to DSP 

convert an array of longs to 

PMzget read a 

PMieee_dsp convert IEEE 

PMzput write a 

PMgetzbuf read a 

PMputzbuf write a 

PMfdIv perform 

floating-point format to the DSP32 

converts internal color value to 

PMfloat_color macro that converts 

floating-point format to the IEEE 

DEVieee_dsp convert from the host's 



editor d31d(l) 

editor d3sim(l) 

enable double buffering mode PMdblbuff(3X) 

enable processing of selected PMenable(3N) 

error DEVerror generate DEVerror(3S) 

error message on standard error DEVerror(3S) 

executable into specified set of/ DEVpipe_boot(3S) 

executable into specified set of/ DEVpixel_boot(3S) 

execution of all pipe and pixel DEVran(3H) 

execution of programs loaded into DEVpipe_run(3S) 

execution of programs loaded into DEVpixel_run(3S) 

fast but dangerous 32 bit D/VRAM PMcopy_f(3X) 

feedback FIFO /read a block DEVfifo_read(3S) 

feedback FIFO /Machines pipelines DEVwrite(3H) 

PM_FLAG LED on or off PMflagled(3X) 

PM_RDY LED on or off PMrdyled(3X) 

FIFO /read a block of four DEVfifo_read(3S) 

FIFO DEVfifo_write write a DEVflfo_write(3S) 

FIFO /Machines pipelines and read DEVwrite(3H) 

FIFO PMfb_on direct output PMfb_on(3P) 

FIFO PMgetcmd PMgetcmd(3X) 

FIFO PMgetdata(3P) 

FIFO commands PMcommand(4N) 

FIFO commands PMcommand(4N) 

FIFO of a pipe node /count PMcopycmd(3P) 

FIFO of a pipe node /get opcode PMgetop(3P) 

FIFO of a pipe node /parameter PMputcmd(3P) 

FIFO of a pipe node PMputdata PMputdata(3P) 

FIFO of a pipe node /write opcode PMputop(3P) 

FIFOs on a pipe board DEVfifo_reset(3S) 

file DEVgetJmage_header read the DEVget_image_header(3S) 

file DEVimage_header DEVimage_header(4) 

file DEVimage_header DEVimage_header(4) 

file DEVputJmage_header write DEVputJmage_header(3S) 

file devsave upload devsave(1) 

file of gamma calibration values DEVIoad_color_tables(3S) 

file to a Pixel Machine devdlsp(1) 

fill a rectangular region of the PMclear(3X) 

flag registers /update overlay DEVpixel_overlay(3S) 

float PMieee_dsp PMieee_dsp(3M) 

float PMIong_dsp PMIong_dsp(3M) 

float from the z buffer PMzget(3X) 

float to DSP float PMieee_dsp(3M) 

float to the Z-buffer PMzput(3X) 

float value from the Z buffer PMgetzbuf(3X) 

float value to the Z buffer PMputzbuf(3X) 

floating point division PMfdiv(3M) 

floating point format /the host's DEVieee_dsp(3S) 

floating point number /macro that PMcolor_float(3N) 

floating point value to internal/ PMfloat_color(3N) 

floating-point format /the DSP32 DEVdspJeee(3S) 

floating-point format to the DSP32/ DEVieee_dsp(3S) 
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DEVdspJeee convert from the DSP32 

format to the IEEE floating-point 

format to the DSP32 floating point 

DEVimageheader 

DEVimage_header 

/from the host's floating-point 

/from the DSP32 floating-point 

printf 

DEVflfo_read read a block of 

DEVfifo_write write a block of 

DEVgetj)ixels read a pixel from the 

read one or more scan lines from a 

DEVput_pixels write pixels into the 

DEVpixel_buffer selects the 

PMswapbuff swap 

PMcopyftob copy 

PMpow power 

PMsin trigonometric 

PMsqrt sqare root 

PMx_exp_n integer power 

space to/ PMfxytoij map a linear 

processor/ PMfxtoi map a linear 

processor/ PMfytoj map a linear 

PMapply apply a 

an angle PMcos trigonometric 

/define a message code and specify 

DEVIoad_color_tables reads file of 

pixel PMpixaddr 

PMzaddrcol 

PMzaddr 

standard error DEVerror 

processor space PMmyx test if a 

processor space PMmyy test if a 

control of the broadcast bus is 

DEVpipe_halt 

DEVpixel_^halt 

Machine device DEVexit 

/read the Pixel Machine image 

/write a Pixel Machine image 

send a user message to the 

formatted output conversion on 

between DSP32 long integer and 

between DSP32 long integer and 

convert from DSP32 long integers to 

Machine code that uses/ devprint a 

between DSP32 short integer and 

from DSP32 short integers to 

PMhost_exit send a message to the 

the/ DEVieee_dsp convert from the 

check status of node's 

check status of node's 

a/ DEVpixelJd_write write a node 



floating-point format to the IEEE/ DEVdspJeee(3S) 

format /the DSP32 floating-point DEVdspJeee(3S) 

format /the hosts floating-point DEVieee_dsp(3S) 

format of a DEVtools image file DEVimage_header(4) 

format of a DEVtools image file DEVimage_header(4) 

format to the DSP32 floating point/ DEVieee_dsp(3S) 

format to the IEEE floating-point/ DEVdspJeee(3S) 

formatted output conversion on host printf(3N) 

four byte values from a pipe/ DEVfifo_read(3S) 

four byte values to a pipe FIFO DEVfifo_write(3S) 

frame buffer DEVgetjDixel, DEVget_pixel(3S) 

frame buffer DEVget_scanJine DEVget_scanJine(3H) 

frame buffer DEVputjDixel DEVput_pixel(3S) 

frame buffer to be displayed DEVpixel_buffer(3S) 

front and back pixel buffers PMswapbuff(3X) 

front to back PMcopyftob(3X) 

function PMpow(3M) 

function PMsin(3M) 

function PMsqrt(3M) 

function PMx__exp__n(3M) 

function of x and y from screen PMfxytoJj(3X) 

function of x from screen space to PMfxtoi(3X) 

function of y from screen space to PMfytoj(3X) 

function to all subscreens PMapply(3X) 

function to compute the cosine of PMcos(3M) 

functions to be called DEVuser_msg_enable(3H) 

gamma calibration values and sets/ DEVIoad_color_tables(3S) 

generate a pointer to a specific PMpixaddr(3X) 

generate a ZRAM pointer to a column PMzaddrcol(3X) 

generate a ZRAM pointer to a row PMzaddr(3X) 

generate an error message on DEVerror(3S) 

given screen space coordinate is in PMmyx(3X) 

given screen space coordinate is in PMmyy(3X) 

granted PMswapj)ipe wait until PMswap__pipe(3H) 

halt a pipe node processor DEVpipe_halt(3S) 

halt a pixel node processor DEVpixel_halt(3S) 

halts processors, closes Pixel DEVexit(3H) 

header from a file DEVgetJmage_header(3S) 

header to a file DEVputJmage_header(3S) 

host PMusermsg PMusermsg(3N) 

host printf printf(3N) 

host long integer /convert DEVbswapl(3S) 

host long integer /convert DEVsswapl(3S) 

host long integers DEVswapJong DEVswapJong(3S) 

host server program for Pixel devprint(1) 

host short integer /convert DEVbswaps(3S) 

host short integers /convert DEVswap_short(3S) 

host that signals the completion of/ PMhost_exit(3N) 

host's floating-point format to DEVieee_dsp(3S) 

ID DEVpipeJd_check DEVpipeJd_check(3S) 

ID DEVpixelJd_check DEVpixelJd_check(3S) 

id block to a reserved location in DEVpixelJd_write(3S) 
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read and print the node 

/read and print the node 

PMieee_dsp convert 

DSP32 floating-point format to the 

space (xmax) to processor space 

space (xmin) to processor space 

format of a DEVtools 

format of a DEVtools 

Machine devdisp download an 

file devsave upload an 

/read the Pixel Machine 

/write a Pixel Machine 

Pixel/ DEVput_scanJine download an 

an image or a portion of an 

PMcopy_v 32- bit copy with variable 

register DEVpixel_mode_init 

PMsioinit 

DEVinit opens and 

get opcode and parameter count from 

PMmsg_setup set serial DMA 

/parameter count, and data from 

DSP32 long integer and host long 

DSP32 short Integer and host short 

DSP32 long integer and host long 

converts internal color value to an 

/convert between DSP32 long 

/convert between DSP32 long 

/convert between DSP32 short 

PMx_exp_n 

PMint_color macro that converts an 

DSP32 long integers to host long 

DSP32 short integers to host short 

/convert from DSP32 long 

/convert from DSP32 short 

PMinterleave 

converts floating point value to 

that converts an integer to an 

PMcolorJnt macro that converts 

PMcolorJIoat macro that converts 

PMsioinit initialize serial 

/updates the serial 

PMsiodir set serial 

space to processor space i and 

screen space to processor space 

space (ymax) to processor space 

space (ymin) to processor space 

d3cc DSP32 C 

PMflagled turn the PM_FLAG 

PMrdyled turn the PM_RDY 

a 3D vector and return its 

PMIdot specialized dot product for 

screen space to/ PMfxytoij map a 



ID of a processor DEVpipeJd_print DEVpipeJd_print(3S) 

ID of a processor DEVpixelJdj)rint(3S) 

IEEE float to DSP float PMieee_dsp(3M) 

IEEE floating-point format /the DEVdspJeee(3S) 

(ihi) PMihi map from screen PMihi(3X) 

(ilo) PMilo map from screen PMilo(3X) 

image file DEVimage_header DEVimage_header(4) 

image file DEVimage_header DEVimage_header(4) 

image from a file to a Pixel devdisp(1) 

image from a Pixel Machine to a devsave(1) 

image header from a file DEVget_image_header(3S) 

image header to a file DEVputJmage_header(3S) 

image or a portion of an image to a DEVput_scanJine(3H) 

image to a Pixel Machine /download DEVput_scan_line(3H) 

Increments PMcopy_v(3X) 

initialize pixel board mode DEVpixel_modeJnit(3S) 

initialize serial I/O PMsioinit(3X) 

initializes Pixel Machine device DEVinit(3H) 

input FIFO of a pipe node PMgetop PMgetop(3P) 

input pointer PMmsg_setup(3X) 

input to output FIFO of a pipe node PMcopycmd(3P) 

integer DEVbswapl convert between DEVbswapl(3S) 

integer DEVbswaps convert between DEVbswaps(3S) 

integer DEVsswapl convert between DEVsswapl(3S) 

integer PMcolorJnt macro that PMcolorJnt(3N) 

integer and host long integer DEVbswapl(3S) 

integer and host long integer DEVsswapl(3S) 

integer and host short integer DEVbswaps(3S) 

integer power function PMx_exp_n(3M) 

integer to an internal color value PMint_color(3N) 

integers DEVswapJong convert from DEVswapJong(3S) 

integers /convert from DEVswap_short(3S) 

integers to host long Integers DEVswapJong(3S) 

Integers to host short integers DEVswap_short(3S) 

interleave or deinterleave a block PMInterleave(3X) 

internal color value /macro that PMfloat_color(3N) 

internal color value /macro PMint_color(3N) 

internal color value to an integer PMcolorJnt(3N) 

internal color value to floating/ PMcolor_float(3N) 

I/O PMsioinit(3X) 

I/O link direction DEVserial_direction(3S) 

I/O link direction PMsiodir(3X) 

j /function of X and y from screen PMfxytoij(3X) 

j /map a linear function of y from PMfytoj(3X) 

(jhi) PMjhi map from screen PMjhi(3X) 

(jlo) PMjIo map from screen PMjlo(3X) 

language compiler d3cc(1) 

LED on or off PMfiagled(3X) 

LED on or off PMrdyled(3X) 

length PMnorm normalize PMnorm(3M) 

light sources PMIdot(3M) 

linear function of x and y from PMfxytoij(3X) 
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space to processor/ PMfxtoi map a 

space to processor/ PMfytoj map a 

/read one or more scan 

updates the serial I/O 

PMsiodir set serial I/O 

d3ld DSP32 

d3sim DSP32 

and receive data packet over serial 

address to a section of/ PMgetzaddr 

into specified set of/ DEVpipe_boot 

into specified set/ DEVpixel_boot 

PMgetcmd 

/begin execution of programs 

/begin execution of programs 

/write a node id block to a reserved 

DEVIock manage Pixel Machine 

PMIong_dsp convert an array of 

calibration values and sets color 

/turns off updating of color 

/turns on updating of color 

DEVclose closes the Pixel 

an image from a file to a Pixel 

or a portion of an image to a Pixel 

/DEVopen_system make a Pixel 

/a host server program for Pixel 

halts processors, closes Pixel 

DEVinit opens and initializes Pixel 

set of/ DEVpipe_boot load a Pixel 

set of/ DEVpixel_boot load a Pixel 

DEVgetJmage_header read the Pixel 

DEVputJmage_header write a Pixel 

DEVIock manage Pixel 

signals the completion of a Pixel 

devcc C compiler for Pixel 

upload an image from a Pixel 

/macros to write to the Pixel 

an internal color/ PMint_color 

value to internal/ PMfloat_color 

value to an integer PMcolorJnt 

value to floating/ PMcolorJIoat 

used to/ PMpagereg, PMdesc, PMxIate 

/DEVcread, DEVreadn, DEVreadn_alt, 

DEVIock 

access/ /PMdesc, PMxIate macros to 

from screen space to/ PMfxytoij 

screen space to processor/ PMfxtoi 

screen space to processor/ PMfytoj 

processor space (ihi) PMihi 

processor space (ilo) PMilo 

processor space (jhi) PMjhi 

processor space (jlo) PMjIo 

space PMxat 



linear function of x from screen PMfxtol(3X) 

linear function of y from screen PMfytoj(3X) 

lines from a frame buffer DEVget_scanJine(3H) 

link direction DEVserial_direction DEVserial_directlon(3S) 

link direction PMsiodir(3X) 

link editor d3ld(1) 

link editor d3sim(1) 

links PMmsg_exchange send PMmsg_exchange(3X) 

load a page register and return an PMgetzaddr(3X) 

load a Pixel Machine executable DEVpipe_boot(3S) 

load a Pixel Machine executable DEVpixel_boot(3S) 

load command from a pixel node FIFO PMgetcmd(3X) 

loaded into specified pipe nodes DEVpipe_run(3S) 

loaded into specified pixel nodes DEVpixel_run(3S) 

location in a pixel node DSP's/ DEVplxelJd_write(3S) 

locks DEVIock(3S) 

longs to float PMIong_dsp(3M) 

lookup tables /reads file of gamma DEVIoad_color_tables(3S) 

lookup tables from shadow tables DEVshadow_off(3S) 

lookup tables from shadow tables DEVshadow_on(3S) 

Machine DEVclose(3S) 

Machine devdisp download devdisp(1) 

Machine /download an image DEVput_scan_line(3H) 

machine available to a user program DEVopen(3S) 

Machine code that uses the print/ devprlnt(1) 

Machine device DEVexit DEVexit(3H) 

Machine device DEVinit(3H) 

Machine executable into specified DEVpipe_boot(3S) 

Machine executable into specified DEVpixel_boot(3S) 

Machine image header from a file DEVgetJmage_header(3S) 

Machine image header to a file DEVputJmage_header(3S) 

Machine locks DEVIock(3S) 

Machine program /to the host that PMhost_exit(3N) 

Machine programs using DEVtools devcc(1) 

Machine to a file devsave devsave(1) 

Machines pipelines and read/ DEVwrite(3H) 

macro that converts an integer to PMint_color(3N) 

macro that converts floating point PMfloat_color(3N) 

macro that converts internal color PMco!orJnt(3N) 

macro that converts Internal color PMcolor_float(3N) 

macros to manipulate page registers PMpagereg(3X) 

macros to write to the Pixel/ DEVwrite(3H) 

manage Pixel Machine locks DEVIock(3S) 

manrpulate page registers used to PMpagereg(3X) 

map a linear function of x and y PMfxytolj(3X) 

map a linear function of x from PMfxtol(3X) 

map a linear function of y from PMfytoj(3X) 

map from screen space (xmax) to PMihi(3X) 

map from screen space (xmin) to PMilo(3X) 

map from screen space (ymax) to PMjhi(3X) 

map from screen space (ymin) to PMjlo(3X) 

map subscreen coordinates to screen PMxat(3X) 
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space PMyat map subscreen coordinates to screen PMyat(3X) 

PMswapback swap meaning of back buffer PMswapback(3) 

location in a pixel node DSP's memory /node id block to a reserved DEVpixel_id_write(3S) 

used to access video and Z memory /manipulate page registers PMpagereg(3X) 

DEVpipe_read reads a block of memory from a pipe DSP DEVpipe_read(3S) 

DEVpixel_read read a block of memory from a pixel DSP DEVpixel_read(3S) 

read a buffer of bytes from the Z memory of a pixel node DEVread_z DEVread_z(3S) 

writes a buffer of bytes into the Z memory of a pixel node DEVwritez DEVwrite_z(3S) 

/clear the software semaphore in the memory of one of the DSP processors 

DEVrelease_pipe_semaphore(3H) 

a scanline or scancolumn from pixel memory without subscreens /or write PMgetrow(3X) 

to be/ DEVuser_msg_enable define a message code and specify functions DEVuser_msg_enable(3H) 

register DEVpixel_get_msg read a message from a pixel DSP's PIR DEVpixel_get_msg(3S) 

DEVpipe_get_msg read a message from the PIR of a pipe DSP DEVpipe_get_msg(3S) 

DEVerror generate an error message on standard error DEVerror(3S) 

PMusermsg send a user message to the host PMusermsg(3N) 

the completion/ PMhost_exit send a message to the host that signals PMhost_exit(3N) 

poll DSP processors for messages DEVpoll_nodes DEVpoll_nodes(3H) 

a pipe board to operate in parallel mode DEVfifo_parallel configure DEVfifo_parallel(3S) 

a pipe board to operate in serial mode DEVfifo_serial configure DEVflfo_serial(3S) 

PMdblbuff enable double buffering mode PMdblbuff(3X) 

PMsnglbuff disable double buffering mode PMsnglbuff(3X) 

DEVpixel_overlay update overlay mode in all pixel processor's flag/ DEVpixel_overlay(3S) 

DEVpixel_mode_overlay set overlay mode in the pixel mode register DEVpixel_mode_overlay(3S) 

initialize pixel board mode register DEVpixel_mode_init DEVpixel_mode_init(3S) 

/set overlay mode In the pixel mode register DEVpixel_mode_overlay(3S) 

bytes from the Z memory of a pixel node DEVread_z read a buffer of DEVread_z(3S) 

bytes Into the Z memory of a pixel node DEVwrite_z writes a buffer of DEVwrite_z(3S) 

from input to output FIFO of a pipe node /parameter count, and data PMcopycmd(3P) 

count from input FIFO of a pipe node /get opcode and parameter PMgetop(3P) 

to the output FIFO of a pipe node /count, and parameters PMputcmd(3P) 

to the output FIFO of a pipe node PMputdata write parameters PMputdata(3P) 

count to the output FIFO of a pipe node /write opcode and parameter PMputop(3P) 

to a reserved location In a pixel node DSP's memory /a node id block DEVpixelJd_write(3S) 

PMgetcmd load command from a pixel node FIFO PMgetcmd(3X) 

PMgetdata get data from a pipe node FIFO PMgetdata(3P) 

location/ DEVpixelJd_write write a node id block to a reserved DEVpixelJd_write(3S) 

DEVpipeJd_print read and print the node ID of a processor DEVpipejdj)rint(3S) 

/read and print the node ID of a processor DEVplxelJd_print(3S) 

DEVpipe_halt halt a pipe node processor DEVpipe_halt(3S) 

DEVplxel_halt halt a pixel node processor DEVpixel_halt(3S) 

into specified set of pipe nodes /a Pixel Machine executable DEVpipe_boot(3S) 

programs loaded into specified pipe nodes /begin execution of DEVpipe_run(3S) 

into specified set of pixel nodes /a Pixel Machine executable DEVpixel_boot(3S) 

loaded into specified pixel nodes /begin execution of programs DEVpixel_run(3S) 

execution of all pipe and pixel nodes DEVrun begin DEVrun(3H) 

DEVpipeJd_check check status of node's ID DEVpipeJd_check(3S) 

DEVpixelJd_check check status of node's ID DEVpixelJd_check(3S) 

call/ DEVwait_exit wait for pixel nodes to signal completion, then DEVwait_exit(3H) 

its length PMnorm normalize a 3D vector and return PMnorm(3M) 

PMdelay do nothing for a specified time PMdelay(3N) 

color value to floating point number /that converts internal PMcolor_float(3N) 
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input FIFO of a pipe/ PMgetop get 

output FIFO of a/ PMputop write 

from input to/ PMcopycmd copy 

parameters to the/ PMputcmd write 

device DEVinit 

/configure a pipe board to 

/configure a pipe board to 

buffer PMputpix 

PMoutpir 

output FIFO PMfb_on direct 

printf formatted 

output commands to the regular 

/count, and data from input to 

/count, and parameters to the 

PMputdata write parameters to the 

opcode and parameter count to the 

DEVpixel_overlay update 

register DEVplxel_mode_overlay set 

PMoverlay turn 

/send and receive data 

decrement references to a 

to a section of/ PMgetzaddr load a 

/PMset_hireg reserve DRAM and 

and 2/ /PMxIate macros to manipulate 

a pipe board to operate in 

input to/ PMcopycmd copy opcode, 

the output/ PMputcmd write opcode, 

a pipe node PMgetop get opcode and 

of a pipe/ PMputop write opcode and 

/write opcode, parameter count, and 

pipe node PMputdata write 

a block of data to a pipe DSP's 

a block of data to a pixel DSP's 

PMfdiv 

DEVrun begin execution of all 

DEVfifo_reset resets all FIFOs on a 

mode DEVfifo_parallel configure a 

mode DEVfifo_serlal configure a 

a stream of bytes from the PIR of a 

read a message from the PIR of a 

read the PIR register of a 

reads a block of memory from a 

DEVpipe_wrlte write a buffer to a 

/write a block of data to a 

a block of four byte values from a 

a block of four byte values to a 

data from input to output FIFO of a 

count from input FIFO of a 

parameters to the output FIFO of a 

parameters to the output FIFO of a 

count to the output FIFO of a 

PMgetdata get data from a 



opcode and parameter count from PMgetop(3P) 

opcode and parameter count to the PMputop(3P) 

opcode, parameter count, and data PMcopycmd(3P) 

opcode, parameter count, and PMputcmd(3P) 

opens and initializes Pixel Machine DEVinit(3H) 

operate in parallel mode DEVfifo_parallel(3S) 

operate in serial mode DEVfifo_serial(3S) 

output a pixel to the current PMputpix(3X) 

output a value to the PIR register PMoutpir(3N) 

output commands to the regular PMfb_on(3P) 

output conversion on host printf(3N) 

output FIFO PMfb_on direct PMfb_on(3P) 

output FIFO of a pipe node PMcopycmd(3P) 

output FIFO of a pipe node PMputcmd(3P) 

output FIFO of a pipe node PMputdata(3P) 

output FIFO of a pipe node /write PMputop(3P) 

overlay mode in ail pixel/ DEVpixel_overlay(3S) 

overlay mode in the pixel mode DEVpixel_mode_overlay(3S) 

overlay on or off PMoverlay(3P) 

packet over serial links PMmsg_exchange(3X) 

page register PMfreezaddr PMfreezaddr(3X) 

page register and return an address PMgetzaddr(3X) 

page registers for dynamic/ PMzbrk(3X) 

page registers used to access video PMpagereg(3X) 

parallel mode /configure DEVfifo_parallel(3S) 

parameter count, and data from PMcopycmd(3P) 

parameter count, and parameters to PMputcmd(3P) 

parameter count from input FIFO of PMgetop(3P) 

parameter count to the output FIFO PMputop(3P) 

parameters to the output FIFO of a/ PMputcmd(3P) 

parameters to the output FIFO of a PMputdata(3P) 

PDR register DEVpipe_put write DEVplpe_put(3S) 

PDR register DEVpixel_put send DEVpixel_put(3S) 

perform floating point division PMfdiv(3M) 

pipe and pixel nodes DEVrun(3H) 

pipe board DEVfifo_reset(3S) 

pipe board to operate in parallel DEVfifo_parallel(3S) 

pipe board to operate in serial DEVfifo_serial(3S) 

pipe DSP DEVpipe_get read DEVpipe_get(3S) 

pipe DSP DEVpipe_get_msg DEVpipe_get_msg(3S) 

pipe DSP DEVpipe_get_pir DEVpipe_^get_pir(3S) 

pipe DSP DEVpipe_read DEVpipe_read(3S) 

pipe DSP DEVpipe_write(3S) 

pipe DSP's PDR register DEVpipe_put(3S) 

pipe feedback FIFO /read DEVflfo_read(3S) 

pipe FIFO D EVf if o_write write DEVfifo_write(3S) 

pipe node /parameter count, and PMcopycmd(3P) 

pipe node /get opcode and parameter PMgetop(3P) 

pipe node /parameter count, and PMputcmd(3P) 

pipe node PMputdata write PMputdata(3P) 

pipe node /opcode and parameter PMputop(3P) 

pipe node FIFO PMgetdata(3P) 
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DEVpipe_halt halt a 

executable Into specified set of 

of programs loaded into specified 

and alternate pipes of a dual 

/to write to the Pixel Machines 

/switch primary and alternate 

read a stream of bytes from the 

read a message from the 

stream of bytes from a pixel DSP's 

read a message from a pixel DSP's 

PMoutpir output a value to the 

DEVpipe_get_pir read the 

DEVpixel_get_pir read the 

generate a pointer to a specific 

DEVpixel_modeJnit initialize 

PMswapbuff swap front and back 

read the PIR register of a 

read a block of memory from a 

DEVpixel_write write a buffer to a 

/send a block of data to a 

/read a stream of bytes from a 

/read a message from a 

PMvOget read a 

PMvlget read a 

PMgetpix read a 

PMqget quick read of a 

DEVgetjDixel, DEVget_pixels read a 

DEVclose closes the 

download an image from a file to a 

image or a portion of an image to a 

DEVopen, DEVopen_system make a 

devprint a host server program for 

DEVexit halts processors, closes 

DEVinit opens and initializes 

specified set/ DEVpipe_boot load a 

specified set/ DEVpixel_boot load a 

file DEVget_image_header read the 

file DEVput_image_header write a 

DEVIock manage 

that signals the completion of a 

DEVtools devcc C compiler for 

devsave upload an image from a 

commands/ /macros to write to the 

write a scanline or scancolumn from 

/set overlay mode in the 

of bytes from the Z memory of a 

of bytes into the Z memory of a 

block to a reserved location in a 

PMgetcmd load command from a 

DEVpixel_halt halt a 

executable into specified set of 

of programs loaded Into specified 



pipe node processor DEVpipe_halt(3S) 

pipe nodes /load a Pixel Machine DEVpipe_boot(3S) 

pipe nodes /begin execution DEVpipe_run(3S) 

pipe system /switch primary DEVswap_pipe(3H) 

pipelines and read commands back/ DEVwrlte(3H) 

pipes of a dual pipe system DEVswap_pipe(3H) 

PIR of a pipe DSP DEVpipe_get DEVpipe_get(3S) 

PIR of a pipe DSP DEVpipe_get_msg DEVpipe_get_msg(3S) 

PIR register DEVpixel_get read a DEVpixel_get(3S) 

PIR register DEVpixel_get_msg DEVpixel_get_msg(3S) 

PIR register PMoutpir(3N) 

PIR register of a pipe DSP DEVpipe_getj)ir(3S) 

PIR register of a pixel DSP DEVpixel_getj)ir(3S) 

pixel PMpixaddr PMpixaddr(3X) 

pixel board mode register DEVplxel_modeJnit(3S) 

pixel buffers PMswapbuff(3X) 

pixel DSP DEVpixel_getj)ir DEVpixel_get_pir(3S) 

pixel DSP DEVpixeljead DEVpixel_read(3S) 

pixel DSP DEVpixel_write(3S) 

pixel DSP's PDR register DEVpixel_put(3S) 

pixel DSP's PIR register DEVpixel_get(3S) 

pixel DSP's PIR register DEVpixel_get_msg(3S) 

pixel from buffer PMvOget(3X) 

pixel from buffer 1 PMv(3X) 

pixel from the current buffer PMgetpix(3X) 

pixel from the current buffer PMqget(3X) 

pixel from the frame buffer DEVget_pixel(3S) 

Pixel Machine DEVclose(3S) 

Pixel Machine devdisp devdisp(1) 

Pixel Machine /download an DEVput_scan_line(3H) 

Pixel machine available to a user/ DEVopen(3S) 

Pixel Machine code that uses the/ devprint(1) 

Pixel Machine device DEVexit(3H) 

Pixel Machine device DEVinit(3H) 

Pixel Machine executable into DEVpipe_boot(3S) 

Pixel Machine executable into DEVpixel_boot(3S) 

Pixel Machine image header from a DEVgetJmage_header(3S) 

Pixel Machine image header to a DEVputJmage_header(3S) 

Pixel Machine locks DEVIock(3S) 

Pixel Machine program /to the host PMhost_exit(3N) 

Pixel Machine programs using devcc(1) 

Pixel Machine to a file devsave(1) 

Pixel Machines pipelines and read DEVwrite(3H) 

pixel memory without subscreens /or PMgetrow(3X) 

pixel mode register DEVpixel_mode_overlay(3S) 

pixel node DEVread_z read a buffer DEVread_z(3S) 

pixel node /writes a buffer DEVwrite_z(3S) 

pixel node DSP's memory /a node id DEVpixelJd_write(3S) 

pixel node FIFO PMgetcmd(3X) 

pixel node processor DEVplxel_halt(3S) 

pixel nodes /load a Pixel Machine DEVpixel_boot(3S) 

pixel nodes /begin execution DEVpixel_run(3S) 
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begin execution of all pipe and 

then call/ DEVwait_exlt wait for 

/update overlay mode In all 

PMpsync wait for all 

PMvOput write a 

PMv1 put write a 

PMputpix output a 

PMqput quick write of a 

DEVput_pixel, DEVput_pixels write 

subscreens 

PMset_hireg/ PMzbrk, PMblockjeg, 

PMsetJowreg, PMset_hireg/ PMzbrk, 

of the screen 

internal color value to floating/ 

internal color value to an integer 

FIFO commands 

FIFO commands 

count, and data from input to/ 

D/VRAM copy 

copy 
increments 



DRAM to another 

compute the cosine of an angle 

mode 

time 

manipulate page/ PMpagereg, 

selected system commands 

the regular output FIFO 

division 

on or off 

floating point value to internal/ 

a page register 

from screen space to processor/ 

X and y from screen space to/ 

from screen space to processor/ 

node FIFO 

or write a scanline or/ PMgetrow, 

FIFO 

count from input FIFO of a pipe/ 

current buffer 

PMputcoI read or write a scanline/ 

subscreen 

return an address to a section of/ 

the Z buffer 

a DRAM block 

host that signals the completion/ 

DSP float 

to processor space (Ihi) 

to processor space (ilo) 



pixel nodes DEVrun DEVrun(3H) 

pixel nodes to signal completion DEVwait_exlt(3H) 

pixel processor's flag registers DEVpixel_overlay(3S) 

pixel processors to synchronize PMpsync(3X) 

pixel to buffer PMv0put(3X) 

pixel to buffer 1 PMv(3X) 

pixel to the current buffer PMputpix(3X) 

pixel to the current buffer PMqput(3X) 

pixels into the frame buffer DEVput_pixel(3S) 

PMapply apply a function to all PMapply(3X) 

PMavailreg, PMsetJowreg PMzbrk(3X) 

PMblock_reg, PMavail_reg PMzbrk(3X) 

PMclearfill a rectangular region PMclear(3X) 

PMcolorJIoat macro that converts PMcolor_float(3N) 

PMcolorJnt macro that converts PMcolorJnt(3N) 

PMcommand data structure used for PMcommand(4N) 

PMcommand data structure used for PMcommand(4N) 

PMcopycmd copy opcode, parameter PMcopycmd(3P) 

PMcopyJ fast but dangerous 32 bit PMcopy_f(3X) 

PMcopyftob copy front to back PMcopyftob(3X) 

PMcopy_s safe 32-bit DRAM or VRAM PMcopy_s(3X) 

PMcopy_v 32- bit copy with variable PMcopy_v(3X) 

PMcopyvtov copy blocks of VRAM PMcopyvtov(3X) 

PMcopyvtoz copy video RAM to DRAM PMcopyvtoz(3X) 

PMcopyztoz copy from one section of PMcopyztoz(3X) 

PMcos trigonometric function to PMcos(3M) 

PMdblbuff enable double buffering PMdblbuff(3X) 

PMdelay do nothing for a specified PMdelay(3N) 

PMdesc, PMxIate macros to PMpagereg(3X) 

PMenable enable processing of PMenable(3N) 

PMfb_on direct output commands to PMfb_on(3P) 

PMfdiv perform floating point PMfdiv(3M) 

PMflagled turn the PM_FLAG LED PMflagled(3X) 

PMfloat_color macro that converts PMfloat_color(3N) 

PMfreezaddr decrement references to PMfreezaddr(3X) 

PMfxtoi map a linear function of x PMfxtoi(3X) 

PMfxytoij map a linear function of PMfxytoij(3X) 

PMfytoj map a linear function of y PMfytoj(3X) 

PMgetcmd load command from a pixel PMgetcmd(3X) 

PMgetcol, PMputrow, PMputcoI read PMgetrow(3X) 

PMgetdata get data from a pipe node PMgetdata(3P) 

PMgetop get opcode and parameter PMgetop(3P) 

PMgetpix read a pixel from the PMgetpix(3X) 

PMgetrow, PMgetcol, PMputrow PMgetrow(3X) 

PMgetscan read a scanline from a PMgetscan(3X) 

PMgetzaddr load a page register and PMgetzaddr(3X) 

PMgetzbuf read a float value from PMgetzbuf(3X) 

PMgetzdesc, PMzdesc_valid allocate PMgetzdesc(3X) 

PMhost_exit send a message to the PMhost_exit(3N) 

PMieee_dsp convert IEEE float to PMieee_dsp(3M) 

PMihi map from screen space (xmax) PMihl(3X) 

PMilo map from screen space (xmin) PMilo(3X) 
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integer to an internal color value 

deinterleave a block 

to processor space (jhi) 

to processor space (jlo) 

light sources 

longs to float 

data packet over serial links 

pointer 

coordinate is in processor space 

coordinate is in processor space 

return its length 

register 

to manipulate page registers used/ 
specific pixel 

processors to synchronize 

count, and parameters to the/ 

or/ PMgetrow, PMgetcol, PMputrow, 

output FIFO of a pipe node 

count to the output FIFO of a pipe/ 

current buffer 

scanline or/ PMgetrow, PMgetcol, 

sub screen 

the Z buffer 

of DRAM to another 

the current buffer 

the current buffer 

or off 

/PMavail_reg, PMsetJowreg, 
PMzbrk, PMblock_reg, PMavail_reg, 



direction 

mode 

buffer 

pixel buffers 

the broadcast bus is granted 

the host 



vertical retrace 

clear 

screen space 

registers used/ PMpagereg, PMdesc, 
screen space 



PMint_color macro that converts an PMint_color(3N) 

PMinterleave interleave or PMinterleave(3X) 

PMjhi map from screen space (ymax) PMjhi(3X) 

PMjIo map from screen space (ymin) PMjlo(3X) 

PMIdot specialized dot product for PMIdot(3M) 

PMIong_dsp convert an array of PMIong_dsp(3M) 

PMmsg_exchange send and receive PMmsg_exchange(3X) 

PMmsg_setup set serial DMA input PMmsg_setup(3X) 

PMmyx test if a given screen space PMmyx(3X) 

PMmyy test if a given screen space PMmyy(3X) 

PMnorm normalize a 3D vector and PMnorm(3M) 

PMoutpir output a value to the PIR PMoutpir(3N) 

PMoverlay turn overlay on or off PMoverlay(3P) 

PMpagereg, PMdesc, PMxIate macros PMpagereg(3X) 

PMplxaddr generate a pointer to a PMpixaddr(3X) 

PMpow power function PMpow(3M) 

PMpsync wait for all pixel PMpsync(3X) 

PMputcmd write opcode, parameter PMputcmd(3P) 

PMputcol read or write a scanline PMgetrow(3X) 

PMputdata write parameters to the PMputdata(3P) 

PMputop write opcode and parameter PMputop(3P) 

PMputplx output a pixel to the PMputpix(3X) 

PMputrow, PMputcol read or write a PMgetrow(3X) 

PMputscan write a scanline to a PMputscan(3X) 

PMputzbuf write a float value to PMputzbuf(3X) 

PMqcopyztoz copy from one section PMqcopyztoz(3X) 

PMqget quick read of a pixel from PMqget(3X) 

PMqput quick write of a pixel to PMqput(3X) 

PMrdyled turn the PM_RDY LED on PMrdyled(3X) 

PMrdyoff turn the ready signal off PMrdyoff(3X) 

PMset_hireg reserve DRAM and page/ PMzbrk(3X) 

PMsetJowreg, PMset_hireg reserve/ PMzbrk(3X) 

PMsetsem set the semaphore PMsetsem(3N) 

PMsin trigonometric function PMsin(3M) 

PMsiodir set serial I/O link PMsiodir(3X) 

PMsioinit initialize serial I/O PMsioinit(3X) 

PMsnglbuff disable double buffering PMsnglbuff(3X) 

PMsqrt sqare root function PMsqrt(3M) 

PMswapback swap meaning of back PMswapback(3) 

PMswapbuff swap front and back PMswapbuff(3X) 

PMswap_pipe wait until control of PMswap_pipe(3H) 

PMusermsg send a user message to PMusermsg(3N) 

PMvOget read a pixel from buffer PMv0get(3X) 

PMvOput write a pixel to buffer PMv0put(3X) 

PMvlget read a pixel from buffer 1 PMv(3X) 

PMv1 put write a pixel to buffer 1 PMv(3X) 

PMvsync synchronize and wait for PMvsync(3X) 

PMwaltsem wait for semaphore to PMwaitsem(3N) 

PMxat map subscreen coordinates to PMxat(3X) 

PMx_exp_n integer power function PMx_exp_n(3M) 

PMxIate macros to manipulate page PMpagereg(3X) 

PMyat map subscreen coordinates to PMyat(3X) 
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a row PMzaddr generate a ZRAM pointer to PMzaddr(3X) 

to a column PMzaddrcol generate a ZRAM pointer PMzaddrcol(3X) 

PMsetJowreg, PMset_hireg reserve/ PMzbrk, PMblockjeg, PMavailjeg PMzbrk(3X) 

PMgetzdesc, PMzdesc_valid allocate a DRAM block PMgetzdesc(3X) 

buffer PMzget read a float from the z PMzget(3X) 

Z-buffer PMzput write a float to the PMzput(3X) 

PMfdiv perform floating point division PMfdiv(3M) 

format to the DSP32 floating point format /floating-point DEVieee_dsp(3S) 

internal color value to floating point number /macro that converts PMcolor_float(3N) 

/macro that converts floating point value to internal color value PMfloat_color(3N) 

PMmsg_setup set serial DMA input pointer PMmsg_setup(3X) 

PMzaddrcol generate a ZRAM pointer to a column PMzaddrcol(3X) 

PMzaddr generate a ZRAM pointer to a row PMzaddr(3X) 

PMplxaddr generate a pointer to a specific pixel PMplxaddr(3X) 

DEVpoll_nodes poll DSP processors for messages DEVpoll_nodes(3H) 

Machine /download an image or a portion of an image to a Pixel DEVput_scanJine(3H) 

PMpow power function PMpow(3M) 

PMx_exp_n integer power function PMx_exp_n(3M) 

dual pipe/ DEVswap_pipe switch primary and alternate pipes of a DEVswap_pipe(3H) 

Pixel Machine code that uses the print routines /server program for devprint(1) 

DEVpipeJdjDrint read and print the node ID of a processor DEVpipeJd_print(3S) 

DEVpixelJdjDrint read and print the node ID of a processor DEVpixelJd_print(3S) 

on host printf formatted output conversion printf(3N) 

commands PMenable enable processing of selected system PMenable(3N) 

DEVpipe_halt halt a pipe node processor DEVpipe_halt(3S) 

read and print the node ID of a processor DEVpipe_id_print DEVpipeJd_print(3S) 

DEVpixel_halt halt a pixel node processor DEVpixel_halt(3S) 

read and print the node ID of a processor DEVpixel_id_print DEVpixelJd_print(3S) 

given screen space coordinate is in processor space PMmyx test if a PMmyx(3X) 

given screen space coordinate is in processor space PMmyy test if a PMmyy(3X) 

function of X from screen space to processor space i /map a linear PMfxtoi(3X) 

of X and y from screen space to processor space i and j /function PMfxytoij(3X) 

map from screen space (xmax) to processor space (ihi) PMihi PMihi(3X) 

map from screen space (xmin) to processor space (ilo) PMilo PMilo(3X) 

function of y from screen space to processor space j /map a linear PMfytoj(3X) 

map from screen space (ymax) to processor space (jhi) PMjhi PMjhi(3X) 

map from screen space (ymin) to processor space (jlo) PMjIo PMjlo(3X) 

in the memory of one of the DSP processors /the software semaphore 

DEVrelease_pipe__semaphore(3H) 

device DEVexit halts processors, closes Pixel Machine DEVexit(3H) 

/update overlay mode in all pixel processor's flag registers DEVpixel_overlay(3S) 

DEVpoll_nodes poll DSP processors for messages DEVpoH_nodes(3H) 

PMpsync wait for all pixel processors to synchronize PMpsync(3X) 

PMIdot specialized dot product for light sources PMIdot(3M) 

a Pixel machine available to a user program /DEVopen_sy stem make DEVopen(3S) 

the completion of a Pixel Machine program /to the host that signals PMhost_exit(3N) 

uses the/ devprint a host server program for Pixel Machine code that devprint(1) 

DEVpipejun begin execution of programs loaded into specified pipe/ DEVpipe_run(3S) 

DEVplxel_run begin execution of programs loaded into specified/ DEVpixel_run(3S) 

devcc C compiler for Pixel Machine programs using DEVtools devcc(1) 

current buffer PMqget quick read of a pixel from the PMqget(3X) 

current buffer PMqput quick write of a pixel to the PMqput(3X) 
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copy DRAM to video RAM (3X) 

PMcopyvtoz copy video RAM to DRAM PMcopyvtoz(3X) 

from a pipe feedback/ DEVfifo_read read a block of four byte values DEVflfo_read(3S) 

DSP DEVpixeljead read a block of memory from a pixel DEVpixel_read(3S) 

memory of a pixel node DEVread_z read a buffer of bytes from the Z DEVread_z(3S) 

PMzget read a float from the z buffer PMzget(3X) 

buffer PMgetzbuf read a float value from the Z PMgetzbuf(3X) 

PIR register DEVpixel_get_msg read a message from a pixel DSP's DEVpixel_get_msg(3S) 

pipe DSP DEVpipe_get_msg read a message from the PIR of a DEVpipe_get_msg(3S) 

PMvOget read a pixel from buffer PMv0get(3X) 

PMvlget read a pixel from buffer 1 PMv(3X) 

buffer PMgetpix read a pixel from the current PMgetpix(3X) 

DEVget_pixel, DEVget_pixels read a pixel from the frame buffer DEVget_pixel(3S) 

PMgetscan read a scanline from a subscreen PMgetscan(3X) 

DSP's PIR register DEVpixel_get read a stream of bytes from a pixel DEVpixel_get(3S) 

of a pipe DSP DEVpipe_get read a stream of bytes from the PIR DEVpipe_get(3S) 

processor DEVpipe_id_print read and print the node ID of a DEVpipeJd_print(3S) 

processor DEVpixelJd_print read and print the node ID of a DEVpixel_id_prlnt(3S) 

to the Pixel Machines pipelines and read commands back from the/ /write DEVwrite(3H) 

buffer PMqget quick read of a pixel from the current PMqget(3X) 

frame buffer DEVget_scanJine read one or more scan lines from a DEVget_scanJine(3H) 

/PMgetcol, PMputrow, PMputcol read or write a scanline or/ PMgetrow(3X) 

controller board/ DEVget_color_map read the color tables from video DEVget_color_map(3S) 

DEVpipe_get_pir read the PIR register of a pipe DSP DEVplpe_get_pir(3S) 

DSP DEVpixel_getj)ir read the PIR register of a pixel DEVpixel_getjDir(3S) 

from a file DEVgetJmage_header read the Pixel Machine image header 

DEVgetJmage_header(3S) 

DSP DEVpipe_read reads a block of memory from a pipe DEVpipe_read(3S) 

values and/ DEVIoad_color_tables reads file of gamma calibration DEVIoad_color_tables(3S) 

PMrdyoff turn the ready signal off PMrdyoff(3X) 

links PMmsg_exchange send and receive data packet over serial PMmsg_exchange(3X) 

PMclearfilla rectangular region of the screen PMclear(3X) 

PMfreezaddr decrement references to a page register PMfreezaddr(3X) 

PMclearfill a rectangular region of the screen PMclear(3X) 

a block of data to a pipe DSP's PDR register DEVpipe_put write DEVpipe_put(3S) 

of bytes from a pixel DSP's PIR register /read a stream DEVpixel_get(3S) 

a message from a pixel DSP's PIR register DEVpixel_get_msg read DEVpixel_get_msg(3S) 

initialize pixel board mode register DEVpixel_modeJnit DEVplxel_modeJnit(3S) 

set overlay mode in the pixel mode register DEVpixel_mode_overlay DEVpixel_mode_overlay(3S) 

block of data to a pixel DSP's PDR register DEVpixel_put send a DEVpixel_put(3S) 

decrement references to a page register PMfreezaddr PMfreezaddr(3X) 

PMoutpir output a value to the PIR register PMoutpir(3N) 

section of/ PMgetzaddr load a page register and return an address to a PMgetzaddr(3X) 

DEVpipe_get_pir read the PIR register of a pipe DSP DEVpipe_getj)ir(3S) 

DEVpixel_get_pir read the PIR register of a pixel DSP DEVpixel_get_pir(3S) 

mode in all pixel processor's flag registers /update overlay DEVpixel_overlay(3S) 

/PMset_hireg reserve DRAM and page registers for dynamic allocation PMzbrk(3X) 

/PMxlate macros to manipulate page registers used to access video and/ PMpagereg(3X) 

direct output commands to the regular output FIFO PMfb_on PMfb_on(3P) 

dynamic/ /PMsetJowreg, PMset_hireg reserve DRAM and page registers for PMzbrk(3X) 

DSP's/ /write a node id block to a reserved location in a pixel node DEVpixelJd_wrlte(3S) 

DEVfifo_reset resets all FIFOs on a pipe board DEVfifo_reset{3S) 
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synchronize and wait for vertical retrace PMvsync PMvsync(3X) 

PMgetzaddr load a page register and return an address to a section of/ PMgetzaddr(3X) 

PMnorm normalize a 3D vector and return its length PMnorm(3M) 

from video controller board and return the value /color tables DEVput_color_map(3S) 

from video controller board and returns value /the color tables DEVget_color_map(3S) 

PMsqrt sqare root function PMsqrt(3M) 

Machine code that uses the print routines /server program for Pixel devprint(1) 

generate a ZRAM pointer to a row PMzaddr PMzaddr(3X) 

PMcopy_s safe 32-bit DRAM or VRAM copy PMcopy_s(3X) 

DEVget_scanJine read one or more scan lines from a frame buffer DEVget_scanJine(3H) 

/read or write a scanline or scancolumn from pixel memory/ PMgetrow(3X) 

PMgetscan read a scanline from a subscreen PMgetscan(3X) 

/PMputrow, PMputcol read or write a scanline or scancolumn from pixel/ PMgetrow(3X) 

PMputscan write a scanline to a subscreen PMputscan(3X) 

fill a rectangular region of the screen PMclear PMdear(3X) 

PMxat map subscreen coordinates to screen space PMxat(3X) 

PMyat map subscreen coordinates to screen space PMyat(3X) 

processor/ PMmyx test if a given screen space coordinate is in PMmyx(3X) 

processor/ PMmyy test if a given screen space coordinate is in PMmyy(3X) 

/map a linear function of x from screen space to processor space i PMfxtoi(3X) 

/a linear function of x and y from screen space to processor space i/ PMfxytolj(3X) 

/map a linear function of y from screen space to processor space j PMfytoj{3X) 

space (Ihi) PMihi map from screen space (xmax) to processor PMihl(3X) 

space (ilo) PMilo map from screen space (xmin) to processor PMilo(3X) 

space (jhi) PMjhi map from screen space (ymax) to processor PMjhi(3X) 

space Qlo) PMjIo map from screen space (ymin) to processor PMjlo(3X) 

register and return an address to a section of DRAM /load a page PMgetzaddr(3X) 

PMcopyztoz copy from one section of DRAM to another PMcopyztoz(3X) 

PMqcopyztoz copy from one section of DRAM to another PMqcopyztoz(3X) 

PMenable enable processing of selected system commands PMenable(3N) 

displayed DEVpixel_buffer selects the frame buffer to be DEVpixel_buffer(3S) 

PMsetsem set the semaphore PMsetsem(3N) 

the DSP/ /clear the software semaphore in the memory of one of 

DEVrelease_pipe_semaphore(3H) 

PMwaitsem wait for semaphore to clear PMwaitsem(3N) 

DSP's PDR register DEVpixel_put send a block of data to a pixel DEVplxel_put(3S) 

signals the completion/ PMhost_exit send a message to the host that PMhost_exit(3N) 

PMusermsg send a user message to the host PMusermsg(3N) 

serial links PMmsg_exchange send and receive data packet over PMmsg_exchange(3X) 

PMmsg_setup set serial DMA input pointer PMmsg_setup(3X) 

PMsloinit initialize serial I/O PMsloinit(3X) 

DEVserial_direction updates the serial I/O link direction DEVserlal_direction(3S) 

PMsiodir set serial I/O link direction PMsiodir(3X) 

send and receive data packet over serial links PMmsg_exchange PMmsg_exchange(3X) 

a pipe board to operate in serial mode /configure DEVflfo_serial(3S) 

code that uses the/ devprint a host server program for Pixel Machine devprint(1) 

Machine executable into specified set of pipe nodes /load a Pixel DEVpipe_boot(3S) 

Machine executable into specified set of pixel nodes /load a Pixel DEVpixel_boot(3S) 

register DEVpixel_mode_overiay set overiay mode in the pixel mode 

DEVpixel_mode_overiay(3S) 

PMmsg_setup set serial DMA input pointer PMmsg_setup(3X) 

PMsiodir set serial I/O link direction PMsiodir(3X) 
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PMsetsem set the semaphore PMsetsem(3N) 

of gamma calibration values and sets color lookup tables /file DEVIoad_color_tables(3S) 

of color lookup tables from shadow tables /turns off updating DEVshadow_off(3S) 

of color lookup tables from shadow tables /turns on updating DEVshadow_on(3S) 

DSP32 short integer and host short integer /convert between DEVbswaps(3S) 

DEVbswaps convert between DSP32 short integer and host short/ DEVbswaps(3S) 

from DSP32 short integers to host short integers /convert DEVswap_short(3S) 

DEVswap_short convert from DSP32 short integers to host short/ DEVswap_short(3S) 

DEVexit /wait for pixel nodes to signal completion, then call DEVwait_exit(3H) 

PMrdyoff turn the ready signal off PMrdyoff(3X) 

/send a message to the host that signals the completion of a Pixel/ PMhost_exit(3N) 

one of the DSP/ /clear the software semaphore In the memory of 

DEVrelease_pipe_semaphore(3H) 

specialized dot product for light sources PMIdot PMIdot(3M) 

space coordinate is in processor space PMmyx test if a given screen PMmyx(3X) 

space coordinate is in processor space PMmyy test if a given screen PMmyy(3X) 

map subscreen coordinates to screen space PMxat PMxat(3X) 

map subscreen coordinates to screen space PMyat PMyat(3X) 

space PMmyx test if a given screen space coordinate is in processor PMmyx(3X) 

space PMmyy test if a given screen space coordinate is in processor PMmyy(3X) 

of X from screen space to processor space i /map a linear function PMfxtoi(3X) 

y from screen space to processor space i and j /function of x and PMfxytoij(3X) 

screen space (xmax) to processor space (Ihi) PMihi map from PMihi(3X) 

screen space (xmin) to processor space (ilo) PMIIo map from PMilo(3X) 

of y from screen space to processor space j /map a linear function PMfytoj(3X) 

screen space (ymax) to processor space (jhi) PMjhi map from Pfi4jhi(3X) 

screen space (ymin) to processor space (jlo) PMjIo map from PMjlo(3X) 

a linear function of x from screen space to processor space i /map PMfxtoi(3X) 

/function of x and y from screen space to processor space i and j PMfxytoij(3X) 

a linear function of y from screen space to processor space j /map PMfytoj(3X) 

(ihi) PMihi map from screen space (xmax) to processor space PMihi(3X) 

(ilo) PMilo map from screen space (xmin) to processor space PMilo(3X) 

Ghi) PMjhi map from screen space (ymax) to processor space PMjhi(3X) 

Glo) PMjIo map from screen space (ymin) to processor space PMjlo(3X) 

sources PMIdot specialized dot product for light PMIdot(3M) 

PMpixaddr generate a pointer to a specific pixel PMpixaddr(3X) 

execution of programs loaded into specified pipe nodes /begin DEVpipe_run(3S) 

execution of programs loaded into specified pixel nodes /begin DEVpixel_njn(3S) 

a Pixel Machine executable into specified set of pipe nodes /load DEVpipe_boot(3S) 

a Pixel Machine executable Into specified set of pixel nodes /load DEVpixel_boot(3S) 

PMdelay do nothing for a specified time PMdelay(3N) 

/define a message code and specify functions to be called DEVuser_msg_enable(3H) 

PMsqrt sqare root function PMsqrt(3M) 

generate an error message on standard error DEVerror DEVerror(3S) 

DEVpipeJd_check check status of node's ID DEVpipeJd_check(3S) 

DEVpixelJd_check check status of node's ID DEVpixelJd_check(3S) 

PIR register DEVpixel_get read a stream of bytes from a pixel DSP's DEVpixel_get(3S) 

pipe DSP DEVpipe_get read a stream of bytes from the PIR of a DEVpipe_get(3S) 

PMcommand data structure used for FIFO commands PMcommand(4N) 

PMcommand data structure used for FIFO commands PMcommand(4N) 

PMgetscan read a scanline from a subscreen PMgetscan(3X) 

PMputscan write a scanline to a subscreen PMputscan(3X) 
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space PMxat map 

space PMyat map 

PMapply apply a function to all 

from pixel memory without 

PMswapbuff 

PMswapback 

of a dual pipe system DEVswap_pipe 

wait for all pixel processors to 

retrace PMvsync 

and alternate pipes of a dual pipe 

enable processing of selected 

values and sets color lookup 

of color lookup tables from shadow 

of color lookup tables from shadow 

/turns off updating of color lookup 

/turns on updating of color lookup 

and/ DEVput_color_map update color 

DEVget_color_map read the color 

coordinate is in processor/ PMmyx 

coordinate is in processor/ PMmyy 

PMsin 

the cosine of an angle PMcos 

PMoverlay 

PMflagled 

PMrdyled 

PMrdyoff 

tables from shadow/ DEVshadow_off 

tables from shadow/ DEVshadow_on 

is granted PMswap_pipe wait 

controller board/ DEVput_color_map 

processor's flag/ DEVpixel_overlay 

direction DEVserial_direction 

from/ DEVshadow^off turns off 

from shadow/ DEVshadow_on turns on 

Machine to a file devsave 

PMusermsg send a 

make a Pixel machine available to a 

program for Pixel Machine code that 

compiler for Pixel Machine programs 

video controller board and returns 

controller board and return the 

point value to internal color 

an integer to an internal color 

PMgetzbuf read a float 

macro that converts internal color 

/macro that converts internal color 

/macro that converts floating point 

PMoutpir output a 

PMputzbuf write a float 

/reads file of gamma calibration 

/read a block of four byte 

/write a block of four byte 



subscreen coordinates to screen PMxat(3X) 

subscreen coordinates to screen PMyat(3X) 

subscreens PMapply(3X) 

subscreens /scanline or scancolumn PMgetrow(3X) 

swap front and back pixel buffers PMswapbuff(3X) 

swap meaning of back buffer PMswapback(3) 

switch primary and alternate pipes DEVswap_pipe(3H) 

synchronize PMpsync PMpsync(3X) 

synchronize and wait for vertical PMvsync(3X) 

system DEVswap^pipe switch primary DEVswap_pipe(3H) 

system commands PMenable PMenable(3N) 

tables /file of gamma calibration DEVIoad_color_tables(3S) 

tables /turns off updating DEVshadow_off(3S) 

tables /turns on updating DEVshadow_on(3S) 

tables from shadow tables DEVshadow_off(3S) 

tables from shadow tables DEVshadow_on(3S) 

tables from video controller board DEVput_color_map(3S) 

tables from video controller board/ DEVget_color_map(3S) 

test if a given screen space PMmyx(3X) 

test if a given screen space PMmyy(3X) 

trigonometric function PMsin(3M) 

trigonometric function to compute PMcos(3M) 

turn overlay on or off PMoverlay(3P) 

turn the PM_FLAG LED on or off PMflagled(3X) 

turn the PM_RDY LED on or off PMrdyled(3X) 

turn the ready signal off PMrdyoff(3X) 

turns off updating of color lookup DEVshadow_off(3S) 

turns on updating of color lookup DEVshadow_on(3S) 

until control of the broadcast bus PMswap_pipe(3H) 

update color tables from video DEVput_color_map(3S) 

update overlay mode in ail pixel DEVpixel_overlay(3S) 

updates the serial I/O link DEVserial__direction(3S) 

updating of color lookup tables DEVshadow_off(3S) 

updating of color lookup tables DEVshadow_on(3S) 

upload an image from a Pixel devsave(1) 

user message to the host PMusermsg(3N) 

user program /DEVopen_system DEVopen(3S) 

uses the print routines /server devprint(1) 

using DEVtools devcc C devcc(1) 

value /read the color tables from DEVget_color_map(3S) 

value /color tables from video DEVput_color_map(3S) 

value /macro that converts floating PMfloat_color(3N) 

value /macro that converts PMint_color(3N) 

value from the Z buffer PMgetzbuf(3X) 

value to an integer PMcolorJnt PMcolorJnt(3N) 

value to floating point number PMcolor_float(3N) 

value to internal color value PMfloat_color(3N) 

value to the PIR register PMoutpir(3N) 

value to the Z buffer PMputzbuf(3X) 

values and sets color lookup tables DEVIoad_color_tables(3S) 

values from a pipe feedback FIFO DEVfifo_read(3S) 

values to a pipe FIFO DEVfifo_write(3S) 
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PMcopy_v 32- bit copy with 

PMnorm normalize a 3D 

PMvsync synchronize and wait for 

page registers used to access 

the value /update color tables from 

value /read the color tables from 

copy DRAM to 

PMcopyvtoz copy 

PMcopyvtov copy blocks of 

PMcopy_s safe 32- bit DRAM or 

synchronize PMpsync 

completion, then call/ DEVwait_exit 

PMwaitsem 

PMvsync synchronize and 

bus is granted PMswap_pipe 

or scancolumn from pixel memory 

DSP's PDR register DEVpipe_put 

to a pipe FIFO DEVfifo_write 

DEVpipe_write 

DEVpixel_write 

PMzput 

PMputzbuf 

location In a/ DEVpixeMd_write 

to a file DEVputJmage_header 

PMvOput 

PMvlput 

pixel/ /PMputrow, PMputcol read or 

PMputscan 

buffer PMqput quick 

the output FIFO of a pipe/ PMputop 

parameters to the output/ PMputcmd 

of a pipe node PMputdata 

DEVput_pixel, DEVput_pixels 

/DEVreadn, DEVreadn_alt, macros to 

memory of a pixel node DEVwrite_z 

PMfxytoij map a linear function of 

PMfxtoi map a linear function of 

PMihi map from screen space 

PMilo map from screen space 

/map a linear function of x and 

PMfytoj map a linear function of 

PMjhi map from screen space 

PMjIo map from screen space 

read a float value from the 

write a float value to the 

PMzget read a float from the 

registers used to access video and 

read a buffer of bytes from the 

/writes a buffer of bytes into the 

PMzput write a float to the 

PMzaddrcol generate a 

PMzaddr generate a 



variable increments PMcopy_v(3X) 

vector and return its length PMnorm(3M) 

vertical retrace PMvsync(3X) 

video and Z memory /to manipulate PMpagereg(3X) 

video controller board and return DEVput_color_map(3S) 

video controller board and returns DEVget_color_map(3S) 

video RAM (3X) 

video RAM to DRAM PMcopyvtoz(3X) 

VRAM PMcopyvtov(3X) 

VRAM copy PMcopy_s(3X) 

wait for all pixel processors to PMpsync(3X) 

wait for pixel nodes to signal DEVwait_exit(3H) 

wait for semaphore to clear PMwaltsem(3N) 

wait for vertical retrace PMvsync(3X) 

wait until control of the broadcast PMswap_pipe(3H) 

without subscreens /a scanline PMgetrow(3X) 

write a block of data to a pipe DEVpipe_put(3S) 

write a block of four byte values DEVfifo_write(3S) 

write a buffer to a pipe DSP DEVpipe_write(3S) 

write a buffer to a pixel DSP DEVpixel_write(3S) 

write a float to the Z-buffer PMzput(3X) 

write a float value to the Z buffer PMputzbuf(3X) 

write a node id block to a reserved DEVpixelJd_write(3S) 

write a Pixel Machine image header DEVputJmage_header(3S) 

write a pixel to buffer PMv0put(3X) 

write a pixel to buffer 1 PMv(3X) 

write a scanline or scancolumn from PMgetrow(3X) 

write a scanline to a subscreen PMputscan(3X) 

write of a pixel to the current PMqput(3X) 

write opcode and parameter count to PMputop(3P) 

write opcode, parameter count, and PMputcmd(3P) 

write parameters to the output FIFO PMputdata(3P) 

write pixels into the frame buffer DEVput_pixel(3S) 

write to the Pixel Machines/ DEVwrite(3H) 

writes a buffer of bytes into the Z DEVwrite_z(3S) 

X and y from screen space to/ PMfxytoij(3X) 

X from screen space to processor/ PMfxtoi(3X) 

(xmax) to processor space (ihi) PMihi(3X) 

(xmin) to processor space (ilo) PMilo(3X) 

y from screen space to processor/ PMfxytoij(3X) 

y from screen space to processor/ PMfytoj(3X) 

(ymax) to processor space (jhi) PMjhi(3X) 

(ymin) to processor space Qlo) PMjlo(3X) 

Z buffer PMgetzbuf PMgetzbuf(3X) 

Z buffer PMputzbuf PMputzbuf(3X) 

z buffer PMzget(3X) 

Z memory /macros to manipulate page PMpagereg(3X) 

Z memory of a pixel node DEVread_z DEVread_z(3S) 

Z memory of a pixel node DEVwrite_z(3S) 

Z-buffer PMzput(3X) 

ZRAM pointer to a column PMzaddrcol(3X) 

ZRAM pointer to a row PMzaddr(3X) 
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NAME 

d3as - DSP32 assembler 

SYNOPSIS 

d3as [options] sourcejiles... 

DESCRIPTION 

Filenames ending with .s or J are assumed to be DSP32 assembly source files. Each specified source 
file is assembled, and a corresponding object file is created with a .o suffix. The valid options are: 

-V Print the version number and exit. 

-N Produce DSP32 object code. (Default mode) 

-Q Produce DSP32C object code. 

-C Retain comments through preprocessor (useful only with -P). 

-P Preprocess the named files and store them in corresponding files with the 

.i suffix. 

-Dn Define n to the preprocessor with value 1. 

-Dn=v Define /i, an identifier, to the preprocessor as if by #define and give it 

value V. 

-Un Undefine n by removing any initial definition of n. 

-Idir The #include files whose names do not begin with / (\ on MS-DOS) 

should be searched for in dir, before looking in the directories on the 
standard list. Thus, #include files whose names are enclosed in " " are 
searched for first in the directory of the filename argument, then in direc- 
tories named in -I options, and last in directories on a standard list. For 
#include files whose names are enclosed in <>, the directory of the 
filename argument is not searched. 

-In (Lower-case L). Produce listing of assembly file. The n, if specified is 

the page length (default is 66 fines). 

-Ifile (Lower-case L). Produce fisting of assembly file and store infile.l. Ufile 

is not specified, the source file names are used (with a .1 extension). 

-n Generate parity bits for the DSP32 device. Note: This option has the 

opposite effect that it had in previous versions of the assembler. 

- W Turn off warning messages. 

-F Treat certain programming violations as warnings, rather than fatal errors. 

See section 3.4 of the DSP32 and DSP32C Support Software Library 
DSP 32 and DSP 32C C Language Compiler 

-A Do not invoke the C preprocessor. 

-p Whenever possible, translate each goto statement to a pc relative goto 

statement (pcgoto). Note that is option does not translate call statements 
to pc relative call statements (pccall). 

-ofile Place output object file in file. 

DIRECTIVE 

The assembler supports the following directives: 
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.rsect sectionname 

This assembler directive allows the user to set up a relocatable program section. The one argu- 
ment to .rsect is a legal identifier enclosed in quotes which is the name of the section. 

.= The .= directive is followed by a constant expression. It sets the current section's location 

counter to the constant value that is on the right of the equal sign. The expression cannot be 
external. 

.align This directive is used to assure that an instruction or data occurs on a legal boundary. It is usu- 
ally used when data space is allocated. The directive has one argument, and integer constant 
that is used to determine that correct alignment. 

.global Once an identifier is used, it is known fi-om that point on in the file. Therefore, every 
identifier in a file must be unique. The identifiers are not known across file boundaries. The 
.global directive is followed by a list of identifiers, separated by commas, that are to be made 
known across file boundaries. The identifiers on the directive line must be defined in that file, 
but are then available to other files that are linked with it. 

.extern If an identifier is listed as external, it is defined and listed as global in another file, but is 
known throughout the local file. The .extern directive is followed by a list of identifiers, 
separated by commas. 

.list Turn on listing. For use with the -1 flag. 

.nolist Turn off listing. For use with the -1 flag. 

.page Skip to the top of a new page. For use with the -1 flag. 

EXAMPLES 

The command 

d3as tests 
wiU produce a file testo which contains the relocatable object code produced by assembling test.s . 

The command 

d3as -1 tests 
will produce an assembly listing written to the file testl. This command also produces a relocatable 
object file, testo. 

NEW FEATURES 

A new form for an unconditional branch instruction is supported for both the DSP32 and the DSP32C. 
This instruction is: 

pcgoto label 

The assembler wiU produce a pc-relative goto which can be dynamically relocated without affecting the 
branch. Presently, there is a restriction that the label must be within the same section as the pcgoto 
instruction using it and within the same file. These restrictions may be lifted at a later time. 

SEE ALSO 

DSP32 C Support Software Library User Manual 

DSP32 and DSP32C Support Software Library DSP32 and DSP32C C Language Compiler 

d3sim(l) 

d3cc(l) 

d31d(l) 



c 



Pixel Machines Last change: Version 1.3.2 (DRAFT) 



d3cc(l) 



DSP Tools 



d3cc(l) 



NAME 

d3cc - DSP32 C language compiler 

SYNOPSIS 

d3cc options sourcejiles 

DESCRIPTION 

The valid options are: 

-N 



-Q 
-P 



~t textseg 
-d dataseg 
-m mapfile 

-s startfile 

-o outfile 
-\xx 

-Wc,argl,[arg2 ...]] 



-Drt 
-Dn=v 

-Urt 
-Mr 



Produce DSP32 object code. (Default mode) 

Produce DSP32C object code. 

Invoke the C preprocessor only. For each file.c, this generates a file.p 
containing the preprocessed C source code. 

Invoke the preprocessor and compiler only. This generates assembly 
source files (s extension) from C source files. 

Invoke the compiler and optimizer only. This generates optimized assem- 
bly files (.i extension) from C or assembly source files (.c or ^ extension, 
respectively). 

Invoke the compiler, optimizer, and assembler only. This generates object 
files (.0 extension) from C or assembly source files (.c or s extension, 
respectively). 

Generate a listing file (.1 extension) of assembled files. The listing is use- 
ful for assembly-level debugging. 

Causes the compiler to load all the program text in the compiled files in a 
section called textseg instead of the default section .text. 

Causes the compiler to load all the global and static data in the compiled 
files in a section called dataseg instead of the default section .data. 

Specifies an alternate memory configuration file (ifile) for use by the 
linker. The default ifiles are mem32.map (for the DSP32) and 
mem32c.map (for the DSP32C) in the directory $DSP32SL/iib. 

Specifies an alternate start-up file for use by the linker. The default start- 
up files are crt0_32.o (for the DSP32) and crt0_32c.o (for the DSP32Q 
in the directory $DSP32SL/lib. 

Specifies the name of the output file. The default output file is a.out. 

Includes the library libjcx32.a or libxx32c.a, depending on whether DSP32 
or DSP32C code is being generated. 

Passes the specified argument(s) (argl ...) to pass c, where c is one of 
{p, c, o, a, or 1} indicating the preprocessor, compiler, optimizer, assem- 
bler, or linker, respectively. 

Define n to the preprocessor with value 1. 

Define n, an identifier, to the preprocessor as if by #define and give it 
value V. 

Undefine n by removing any initial definition of n. 

The #include files whose names do not begin with / (\ on MS-DOS) 
should be searched for in dir, before looking in the directories on the 
standard list. Thus, #include files whose names are enclosed in " " are 
searched for first in the directory of the filename argument, then in 
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directories named in -I options, and last in directories on a standard list. 
For finclude files wliose names are enclosed in <>, the directory of the 
filename argument is not searched. 

-n Generate parity bits for the DSP32 device. Note: ITiis option has the 

opposite effect that it had in previous versions of the assembler. 

-T Trace program execution. d3cc prints command lines used to invoke the 

preprocessor, compiier, optimizer, assembler, ^d linker. Useful for 
debugging problems with dScc command strings. 

SEE ALSO 

DSP32 C Language Compiler User Manual d3as(l) 

d3siM(l) 

d31d{l) 



( 
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NAME 



d31d - DSP32 link editor 



SYNOPSIS 

d31d [options] [ifile] objjiles... 

DESCRIPTION 

The d31d command links the named objjiles object files, produced by d3as or d3cc, and puts the result- 
ing object file into a.out unless otherwise specified. The ifile is an ASCII file containing directives. 



The valid options are: 
-a 



'ffill 
-\x 



-m 



-o outfile 



-s 



-u symname 



L dir 



-M 



-N 
-V 



Produces an absolute, executable file; gives warnings for undefined refer- 
ences. Relocation information is stripped from the output file unless the 
-r option is given. The -r option is needed only when an absolute file 
should retain its relocation information (not the normal case). If neither 
-a nor ~r is given, -a is assumed. 

Sets the default fill pattern for "holes" within an output section as well as 
initialized bss sections. The argument jft// is a two-byte constant. 

Searches a library libjc^, where x is up to nine characters. A library is 
searched when its name is encountered, so the placement of a -1 is 
significant. By default, libraries are located in the directory lib within the 
directory specified by the environment variable DSP32SL. 

Produces a map or listing of the input/output sections (including holes) on 
the standard output 

Produces an output object file by the name outfile. The default name of 
the object file is a.out. 

Retains relocation entries in the output object file. Relocation entries 
must be saved if the output file is to become an input file in a subsequent 
Id run. The link editor does not complain about unresolved references, 
and the output file is not executed. 

Strips line number entries and symbol table information from the output 
object file. This function can also be performed using the utility d3strip. 

Enters symname as an undefined symbol in the symbol table. This is use- 
ful for loading entirely from a library, since initially the symbol table is 
empty and an unresolved reference is needed to force the loading of the 
first routine. 

Does not preserve local (non-.global) symbols in the output symbol table; 
enters external and static symbols only. This option saves some space in 
the output file. 

Changes the algorithm of searching for lib;i[:.a to look in dir before look- 
ing in DSP32SL/lib. This option is effective only if it precedes the -1 
option on the command line. 

Outputs a message for each multiply-defined external definition. How- 
ever, if the objects loaded include debugging information, extraneous out- 
put is produced. 

Puts the data section immediately following the text in the output file. 

Outputs a message giving information about the version of d31d being 
used. 

Generate parity bits for DSP32 device. Note: This option has the 
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opposite effect that it had in previous versions of the linker. V 

Flags can be combined with file names on both the command line and in an ifile. The ordering of flags 
is insignificant with the exception of the -1 flag for specifying hbraries. Libraries are searched as they 
are encountered for any undefined external references. 

SEE ALSO 

DSP32 C Support Software Library User Manual 

d3as(l) 

d3sim(l) 

d3cc(l) 



( 



( 
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NAME 

d3sim - DSP32 link editor 

SYNOPSIS 

d3sim [options] file 

DESCRIPTION 

The file is the DSP32 executable program file that is being simulated. The valid options are: 

-c The -c option must be used with programs that were compiled by the 

DSP32/DSP32C C compiler. This option allows breakpoints to operate 
correctly, allows the printf function to be used in the program, and also 
allows registers rl4, rl8, and rl9 to be referred to as sp (stack pointer), 
rp (return pointer), and ir (increment register), respectively. The ftrace 
command (trace function calls) is also available. 

-T Time run. The time taken to run the simulation on the host computer is 

displayed (in seconds) at the end of a simulation run. (This is not the 
time that the physical device takes to run the same program). 

-e Exec file. This option causes a text file of commands to be executed. The 

name of the file is assumed to be file.ex, where file is the name of the 
program file. It is useful to produce such a file and put into it definitions 
of any functions that would be useful in debugging that particular pro- 
gram. 

-mn Memory Mode Specification. This option specifies the memory mode. 

The value of n can be through 3 for DSP32 programs or through 7 for 
DSP32C programs. If it is not specified, the mode defaults to 2 for the 
DSP32 or 6 for the DSP32C. If no mode flag is present, d3sim allows 
writes to ROM with no complaint. 

~1 Log Commands. This option causes "command logging" to be turned on. 

If input is from a terminal, it gets written to a file called log.cmd. If 
input is from a file, then as it is read, it gets written to standard output. 
Thus, each line of output is preceded by the command line that caused it, 
which can be useful in identifying unexpected results. 

-b Tum off breakpoint verbose mode. No message is printed when a break- 

point occurs. Note: This option has the opposite effect that it had in pre- 
vious versions of the simulator. 

-d# Development system specifier. Sets the simulator in development system 

mode. The # specifies the number of the DSP32 development system that 
is being controlled (see the WE®DSP32-DS Development System User 
Manual for details). 



-D/dev/alt_port 



Device Driver Select. UNIX SYSTEM ONLY 

The /dcw/alt'port is used if the DSP32 development system is connected 
to a port other than the user's tty port. The /dew/alt j)ort is the UNIX 
System device driver of the port to which the development system is con- 
nected (see the WE®DSP32-DS Digital Signal Processor Development 
System User Manual for details). 



-Cfile.c{g 



DSP32C Development System in use. Refer to the WE®DSP32C 
Development System User Manual for complete details. 

-Z Disables "dirty-zero" checking in the DAU. By default, a dirty-zero error 

occurs when a number has a nonzero exponent and a mantissa of zero. 
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-p Turn on profiling. The profiling feature requires a large amount of ^ 

memory, which may cause problems on some systems. Therefore, it is 
not active by default. 

-R DSP32C mode only. Run DSP32C as a ROM device. 

-P Set default pew value to 0. Normal default is Ox3f. 

-An DSP32C mode only. Set number of wait states for external memory bank 

A to n, 

-Bn DSP32C mode only. Set number of wait states for external memory bank 

B ion. 

~w n Sets the number of conflict wait states to remember to n. This determines 

the number of conflict wait states that are displayed when the waits com- 
mand is issued. 

-S # Enable stack range checking. The argument # is an upper bound the stack 

pointer should not exceed. 

Prior to accepting user command input, d3sim loads memory from the given file and initializes as if a 
chip reset has occured. 

SEE ALSO 

DSP32 C Support Software Library User Manual 

d3as(l) 

d3cc(l) 

d31d(l) 
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NAME 

devcc - C compiler for Pixel Machine programs using DEVtools 

SYNOPSIS 

devcc <d3cc options> [-pixel | -pipe] <source files> 

DESCRIPTION 

devcc is the DSP32 compiler used with DEVtools programs. It is the same as d3cc but it knows about 
Pixel Machine specific files. In addition to the directories searched by d3cc for include files, devcc also 
searches $HYPER_PATH/devtools/include. devcc also passes the correct startup file and loader direc- 
tive file (ifile) to d31d as well as the $HYPER_PATH/devtools/lib/libpm.a library. 

devcc takes all the options that d3cc does plus -pixel (default) and -pipe options. 

The -pipe option is used to link pipe programs and causes crtO_pipe.o and pipeifile to be used. 

The -pixel option is for pixel programs and causes crtOpixel.o and pixelifile to be used. 

NOTES 

If users want to use printf with d3sim, they should include $DSP32SL/include/printf.c on the devcc 
command line to prevent loading the printf that is included in libpm.a. 

SEE ALSO 

DSP32 C Language Compiler User Manual 

DSP 32 Support Software Library and DSP32 C Language Compiler Version L3.1 Addendum 
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NAME 

devdisp - download an image from a file to a Pixel Machine. 

SYNOPSIS 

devdisp [-p initx inity] [-s npixels nlines] [-o xoffset yolTset] [-b buffer] [~d] [-v] [-u] file 

DESCRIPTION 

devdisp is used to download an image from a file to a Pixel Machine. The file specified must be in 
DEVtools image format as specified in DEVimage_header(4). 

The following options are supported: 

-p initx inity the image download will begin at pixel (initx, inity). Default is (0,0) 

(upper left hand comer of the screen). 

-s npixels nlines a rectangular section of pixels specified by (npixels, nlines) will be down- 

loaded. Default is the size of the image as specified in the file. 

"0 xoffset yoffset if specified, xoffset pixels and yoffset lines are skipped in the image file 

before downloading. This is used to download only a portion of the 
image file. Default is 0, 0. 

-d the image download will begin at the pixel specified in the image file. 

This option is useful when an image was saved from a specific location 
on the screen and the user wishes to display it at the same location. This 
option overrides the -p option. 

-b buffer the image will be downloaded to the specified portion of the frame buffer. 

Valid values for buffer are: 

front - pixels are downloaded to the front (currently displayed) buffer 
(default). 

back - pixels are downloaded to the back (currently non- displayed) 
buffer. 

vramO - pixels are downloaded to VRAMO. 

vraml - pixels are downloaded to VRAMl. 

zram - pixels are downloaded to ZRAM. 

-V verbose output will be written to the standard output. 

-u print usage information. 

RETURNS 

The exit code will be upon success, non- zero on failure. 
NOTES 

devdisp downloads code into the pipe and pixel nodes to perform the image download, consequently 

any programs that had been downloaded will be overwritten. 
SEE ALSO 

DEVimage_header(4) 

DEVput scan line(3H) 

devsave(l) 

picdisp(l) in the PIClib Reference Manual 

raydisp(l) in the RAYlib Reference Manual 
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NAME 

devprint - a host server program for Pixel Machine code that uses the print routines 

SYNOPSIS 

devprint [-d node all] [-g node all] [-u] [-i] [-n] 

DESCRIPTION 

devprint is a program that runs on the host system that polls a selected set of pipe and/or pixel nodes 
and performs the host processing required by any system messages sent from the nodes, usually the mes- 
sages for FMhostexit, PMsiodir and printf. 

The following options may be used: 

-d node poll pixel node node for print messages 

-dall poll all pixel nodes for print messages 

-gnode 

poll pipe node node for print messages 

-gall poll all pipe nodes for print messsages 

-i print node identification information for node printf commands 

-n causes devprint to poll all nodes specified, but discards all the messages except from the 
first pipe and pixel node specified on the command line. This is used for debugging 
when it is not necessary to see the output of all of the nodes, but they must be polled so 
they do not hang waiting for the host to read a message. Care must be taken when using 
this option because commands executed on the other nodes will not function properly if 
they expect a response from the host. 

-u print command usage format 

If no node specification is provided, all pipe and pixel nodes are polled for print messages. 



EXAMPLES 



devprint - poll and print for all nodes 

devprint -n - only prints output for Pipe and Pixel node 

devprint -gall -dall -n - only prints output for Pipe and Pixel node 

devprint -n -g8 -dS - prints foir pipe #8 and Pixel #5 



SEE ALSO 

DEVpoll_nodes(3S) 
PMhost_exit(3N) 
PMsiodir(3X) 
printf(3N) 
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NAME 

devsave - upload an image from a Pixel Machine to a file 

SYNOPSIS 

devsave [-p itiitx inity] [-s npixels nlines] [-b buffer] [-m mode] [-v] [-u] file 

DESCRIPTION 

devsave is used to upload an image that exists in the frame buffer of a Pixel Machine into a file on the 
host computer. The image is stored in file in the format specified by mode. The uploaded file will con- 
tain an initial DEVtOOlS header. See the DEVimage_header(4) manual page for a description of the 
Pixel Machines image header. Each pixel component (red, green, blue and alpha) consumes 8 bits and 
is byte aligned, file will be overwritten if it exists. 

The following options are supported: 

-p initx inity the image upload will begin at pixel (initx, inity). Default is (0,0) (upper 

left hand corner of the screen), 
-s npixels nlines a rectangular section of pixels specified by (npixels, nlines) will be 

uploaded. Default is the size of the screen. 
-b buffer the image will be uploaded from the specified portion of the frame buffer. 

Valid values for buffer are: 

front - pixels are uploaded from the front (currently displayed) buffer 
(default). 

back - pixels are uploaded from the back (currently non- displayed) 
buffer. 

vramO - pixels are uploaded from VRAMO. 

vraml - pixels are uploaded from VRAMl. 

zram - pixels are uploaded from ZRAM. 

-m mode the image will be uploaded according to the format specified in mode. 

Valid values for mode are: 

rgba ~ pixels are stored in red, green, blue, alpha format (default). 

rgb - pixels are stored in red, green, blue format. 

a - only the alpha component of the pixel is stored. 

b - only the blue component of the pixel is stored. 

g - only the green component of the pixel is stored. 

r - only the red component of the pixel is stored. 

ajnono - the alpha component of the pixel is stored, and the image 
header is set to mono (for later monochrome display). 

bjnono - the blue component of the pixel is stored, and the image 
header is set to mono (for later monochrome display). 

gjnono - the green component of the pixel is stored, and the image 
header is set to mono (for later monochrome display). 

rjnono - the red component of the pixel is stored, and the image 
header is set to mono (for later monochrome display). 

mx)no - pixels will be read 8 bits at a time from ZRAM only. 
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16 - pixels will be read 16 bits at a time from ZRAM only. ^ 

dsp - pixels will be read 32 bits at a time from ZRAM only. 

ieee - DSP floats will be converted to IEEE floats in ZRAM and 
uploaded. After the floats are uploaded, the values in ZRAM are con- 
verted back to DSP floats. 

-V verbose output will be written to the standard output. 

-u print usage information. 

RETURNS 

The exit code will be upon success, non-zero on failure. 
NOTES 

devsave downloads code into the pipe and pixel nodes to perform the image upload, consequently any 

programs that had been downloaded will be overwritten. 
SEE ALSO 

DEVimageJieader(4) 

DEVget_scan_line(3H) 

devdisp(l) 

picsave(l) in the PIClib Reference Manual 

raysave(l) in the RAYlib Reference Manual 
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NAME 

DEVbswapl - convert between DSP32 long integer and host long integer 

SYNOPSIS 

#iiiclude <host/devtools,h> 

long DEVbswapl(number) 
long number; 

DESCMPTION 

DEVbswapl (byte swap long) converts a long integer in DSP32 format to a long integer in the host for- 
mat, and vice- versa. DEVbswapl is implemented as a macro which returns the value of number with 
the bytes in reverse order. 

SEE ALSO 

DEVswap_long(3S) 
DEVbswapl(3S) 
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NAME 

DEVbswaps - convert between DSP32 short integer and host short integer 

SYNOPSIS 

#mclude <host/devtools.h> 

short DEVbswaps(number) 
short number; 

DESCRIPTION 

DEVbswaps (byte swap short) converts a short integer in DSP32 format to short integers in the host 
format and vice- versa. DEVbswaps is implemented as a macro which returns the value of number with 
the high and low bytes swapped. 

SEE ALSO 

DEVswap_short(3S) 
DEVbswaps(3S) 
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NAME 

DEVclose - closes the Pixel Machine 

SYNOPSIS 

void DEVcloseO 

DESCRIPTION 

DEVclose closes the Pixel Machine designated by the environment variable HYPER_UNIT. Closing 
the device consists of closing the file associated with the VME device, releasing the memory blocks that 
were mapped to the device, and removing the lock file. 

The system status file is updated to reflect any changes that may have occurred during the execution of 
the program since the device was opened. 

NOTES 

DEVexit rather than DEVclose is usually used. DEVopen and DEVclose are provided for users that 
require lower level control of the system. 

SEE ALSO 

DEVexit(3H) 
DEVopenOS) 
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NAME 

DEVdsp_ieee - convert from the DSP32 floating-point format to the IEEE floating-point format 

SYNOPSIS 

#include <host/devtools.h> 
float DEVdspieeeCn) 
long n; 

DESCRIPTION 

The host and the DSP32 use different formats for floating point numbers. DEVdsp_ieee converts a sin- 
gle 32 bit floating point number in DSP32 format to the IEEE floating point format used by the host. 
The number to be converted is stored in the 32 bit long n. The contents of n must be in the correct host 
byte order. A value read from the Pixel Machine must be converted using DEVbswapK) or 
DEVswapJongO before caUing DEVdsp_ieee(). 

RETURNS 

DEVdspJeee returns a floating point number with the same value as the DSP32 floating point number. 

SEE ALSO 

DEVieee_dsp(3S) 
DEVbswapl(3S) 
DEVswap short(3S) 
DEVswapJong(3S) 
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NAME 

DEVerror - generate an error message on standard error 

SYNOPSIS 

#include <host/devtools.h> 
#iiiclude <host/deverror.h> 

void DEVerror(msg) 
char *msg; 

char DEVerror_msg[]; 
int DEVerrno; 

DESCRIPTION 

DEVerror is the DEVtOOls equivalent of the UNIX system perrorQ function. It is used to generate an 
error message on standard error describing the last error that occurred during a call to a DEVtOOlS host 
function. 

A message of the form: 

msg: error message 

is generated. 

Error messages can also be formatted by user programs by accessing the global variable 
DEVerrormsg. User programs can check for specific errors by comparing the global variable 
DEVerrno with the symbolic names defined in the deverror.h include file. 

NOTES 

It is possible for some DEVtools routines to fail because of errors returned from system calls. When 
this occurs, DEVerrno contains the value DEV_ERR_SYSTEMERR, and the contents of 
DEVerror_msg is undefined. Therefore, user error message handlers should not display 
DEVerrormsg for system errors. 

SEE ALSO 

perror on host system 
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NAME 

DEVexit - halts processors, closes Pixel Machine device 

SYNOPSIS 

void DEVexitO 

DESCRIPTION 

DEVexit halts the processors, closes the device associated with the Pixel Machine, and restores the 
default handling of signals intercepted by DEVinit. DEVexit should always be called before exiting 
any host program that uses DEVinit. 

NOTES 

DEVexit does not wait for the Pixel Machine to finish any outstanding commands. Use DEVwait_exit 
to guarantee that the pixel nodes are done. 

SEE ALSO 

DEVclose(3S) 
DEVinitOH) 
DEVwait exit(3H) 
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NAME 

DEVfifo_parallel - configure a pipe board to operate in parallel mode 

SYNOPSIS 

#mclude <host/devtools.h> 

void DEVfifojparallel(system, fifo) 
DEVpixelsystem *system; 
int fifo; 

DESCRIPTION 

DEVfifojparallel configures a pipe board to operate in parallel mode. This mode can only be used in 
systems with two pipe boards. A call to this function must be made for each pipe card in the system. 
fifo is the number of the pipe board whose FIFO is to be configured in parallel. 

NOTES 

DEVfifoparallel is automatically called by DEVinit and DEVopen on dual parallel pipe systems as 
specified by the HYPER_MODEL and HYPER_PIPE environment variables. 

SEE ALSO 

DEVfifo_serial(3S) 

DEVinit(3H) 

DEVopen(3S) 
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NAME 

DEVfifo_read - read a block of four byte values from a pipe feedback FIFO 

SYNOPSIS 

#mclude <host/devtools.h> 

int DEVfifo_read(input, inputflags, buffer, nwords) 
DEVulong *input; 
DEVbyte *mput_flags; 
DEVulong *buffer; 
int nwords; 

DESCRIPTION 

DEVfiforead reads a block of four byte values from a pipe node feedback FIFO. This is done by 
copying the data from the memory mapped address of the feedback FIFO. 

input is a pointer to the memory mapped area that the data is to be read from, input Jlags is a pointer 
to the memory mapped location of the input flags of the pipe board. 

buffer is a pointer to the location into which the data is to be read, nwords is the number of four byte 
values to be read. 

NOTES 

THE DEVcread macros should be used for most applications. 

DEVfiforead always returns zero. 

DEVfiforead cannot be used on a system without pipe boards. 

SEE ALSO 

DEVfifo_write(3S) 
DEVwrite(3H) 
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NAME 

DEVfiforeset - resets all FIFOs on a pipe board 

SYNOPSIS 

#include <host/devtools.h> 

void DEVfifo_reset(pixel_systein,fifo) 
DEVpixelsystem *pixel_system; 
int fifo; 

DESCRIPTION 

DEVfiforeset resets all the FIFOs on a pipe board, fifo is the number of the pipe board to be reset 

NOTES 

Resetting a pipe board empties all of its FIFOs. 



DEVfiforeset is automatically called by DEVinit and DEVopen. 
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NAME 

DEVfifo_serial - configure a pipe board to operate in serial mode 

SYNOPSIS 

#mclude <host/devtools.h> 

void DEVfifo_serial(pixel_system,fifo) 
DEVpixelsystem *pixel_system; 
int fifo; 

DESCMPTION 

DEVfifo_serial configures a pipe board to operate in serial mode. This mode can be used in systems 
with two pipe boards. A call must be made for each pipe card in the system, fifo is the number of the 
pipe card. 

NOTES 

DEVfifo_serial is automatically called by DEVinit and DEVopen on dual serial pipe systems as 
specified by the HYPER_MODEL and HYPERPIPE environment variables. 

SEE ALSO 

DEVfifojarallel(3S) 
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NAME 

DEVfifo_write - write a block of four byte values to a pipe FIFO 

SYNOPSIS 

#include <host/devtools.h> 

int DEVfifo_write(output, outputflags, buffer, nwords) 
DEVulong ^output; 
DEVbyte *outputJlags; 
DEVulong *buiTer; 
int nwords; 

DESCRIPTION 

DEVfifo_write writes a block of four byte values to a pipe FIFO. This is done by copying the data to 
the memory mapped address of the FIFO. 

output is a pointer to the memory mapped area that the data is to be written to. output Jlags is a pointer 
to the memory mapped location of the output flags of the pipe board. 

buffer is a pointer to the data to be written, nwords is the number of four byte values to be written. 

NOTES 

DEVfifowrite always returns zero. 

DEVfifo_write cannot be used to write directly to the broadcast bus FIFO. 

The DEVwrite macros provide a more efficient mechanism to write to a pipe FIFO. 

SEE ALSO 

DEVfifo_read(3S) 
DEVwrite(3H) 
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NAME 

DEVget_color_map - read the color tables from video controller board and returns value 

SYNOPSIS 

#include <host/devtools.h> 

void DEVgetcolormapCpixelsystenij r, g, b) 
DE Vpixelsystem * pixelsy stem ; 

int r[DEV VIDEOTABLE] ; 

int g[DEV VIDEOT ABLE] ; 

int b[DEV VIDEO__TABLE]; 

DESCRIPTION 

DEVget_color_map reads the color tables from the video controller board and returns the values to the 
caller. Each color table contains 256 entries; each entry is a 10- bit value (0-1023)« 

SEE ALSO 

DEVputcolor map(3S) 
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NAME 

DEVget_image_header - read the Pixel Machine image header from a file 

SYNOPSIS 

#in€lude <stdio.h> 
#include <host/devtooIs.h> 
#mclude <host/devimage.h> 
#include <host/deverror.h> 

int DEVget_imageJlieader(file, image header, optionalheader) 
FILE *file; 

DEVimageheader *image_header; 

DEVbyte * *optional_header; 

DESCRIPTION 

DEVgetJmageheader reads the DEVimage_header and the optional header (if one exists) from the 
specified file and returns them to the caller. 

file is a file descriptor obtained from a previous call to fopen(3). The file must have been successfully 
opened for reading and the file pointer should be pointing to the beginning of the file (i.e., no previous 
reads have been issued). Upon return from DEVget imageheader, the file pointer will be set to the 
beginning of the pixel data (i.e., past the image and optional headers). 

DEVget imageheader will read in the first DEV IMAGE HEADER SIZE bytes from the file, con- 
vert them from ASCII into unsigned longs and place them into the correct locations in the structure 
pointed to by imagejieader. Except for the magic and optional _header_size fields, none of the infor- 
mation in the header is checked for validity. 

If an optional header is present (image_header->optional_header_size is not 0), memory will be allo- 
cated (via malloc(3)) and image Jieader->optionalJieader_size bytes will be read. A pointer to the 
allocated memory will be returned in * optional Jieader, If no optional header is present, 
*optional_header will be set to NULL. 

RETURNS 

DEVgetimageheader returns upon success and -1 on failure. DEVgetimageheader will set 
DEVerrno to indicate the reason for failure: 

DEV_ERR_BAD_^MAGIC: the magic number is not DEV IMAGE MAGIC. 

DEVERRREADERR: an error was returned by \hQ,fread(3) system call while reading either the 
image header or the optional header. 

SEE ALSO 

DEVimage_header(4) 
DEVput_image_header(3S) 
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NAME 

DEVget jpixel, DEVget_pixels - read a pixel from the frame buffer 

SYNOPSIS 

#include <host/devtools.h> 

void DEVget j)ixel(system, buffer, x, y, r, g, b, o) 
DEVpixelsystem *system; 
int buffer, x, y; 
short *r, *g, *b, *o; 

void DEVget jpixels(system, buffer, x, y, r, g, b, o, npixl) 
DEVpixel_system *system; 
int buffer, x, y; 
short *r, *g, *b, *o; 
int npixl; 

DESCRIPTION 

DEVgetpixel reads a pixel from the frame buffer. By using this routine, a program can read the Pixel 
Machine frame buffer without having to deal with the details of how the frame memory is organized on 
different models of the system. 

system is a pointer to the system description information returned by DEVinit. buffer indicates which 
frame buffer is to be updated (must be the value ot 1). x is the x coordinate, y is the y coordinate, r, 
g, b, and o are pointers to the locations into which the values of the red, green, blue, and overlay values 
from the frame buffer are to be stored. 

DEVget_pixels reads a sequence of pixels for a single scan line, npixl is the number of pixels to be 
read, r, g, b, and o point to the locations into which the values of red, green, blue, and overlay values 
to be stored. 

NOTES 

DEVgetscanline provides a more efficient and versatile way to upload images. 

SEE ALSO 

DEVpixel_read(3S) 
DEVgetscan Une(3H) 
DEVinit(3H) 
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NAME 

DEVget_scan_line - read one or more scan lines from a frame buffer 

SYNOPSIS 

#include <host/devtools.h> 
#include <host/devimage.h> 

int DEVget_scaii_line(systein, x, y, npixl, nlines, mode, pixels) 

DEVpixelsystem *system; 

unsigned int x, y; 

unsigned int npixl, nlines, mode; 

DEVbyte *pixels; 

DESCRIPTION 

DEVget_scan_line reads one or more scan lines from the frame buffer and packs the pixels into pixels 
according to the mode specified by mode. By using this routine, a program can read scan lines from a 
Pixel Machine frame buffer without having to deal with the details of how the frame memory is organ- 
ized on different models of the system. 

system is a pointer to the system description information returned by DEVinit. x is the starting x screen 
coordinate, y is the starting y screen coordinate. 

DEVget_scanJine reads a sequence of pixels for one or more scan lines, npixl is the number of pixels 
to be read from each scan line, nlines scan lines will be read, pixels points to the location into which 
the pixel values will be stored. 

The buffer pointed to by pixels must be large enough to store (npixl * nlines * pixel size) bytes, where 
the pixel size is determined by the mode argument as described below. In all cases, pixels will be stored 
in pixels in the following order: (jc,y), (jf+l,y), ..., (jc+/ipa/-l,y), (jc,}H-1), ..., (x-¥npixhlyy-¥nlines-l). 

The mode argument is used to specify two independent pieces of information: how the pixels will be 
stored in the array pointed to by pixels, and which portion of Pixel Machine memory the data should be 
copied from. These two values are or'ed into the mode argument. Valid values for mode and their 
results are: 

DEV RGBA_PACKED__PIXELS: pixels will be stored in pixels, 4 bytes to a pixel, in the fol- 
lowing order, red, green, blue, alpha. 

DEV_RGB_PACKED__PIXELS: pixels will be stored in pixels, 3 bytes to a pixel, in the fol- 
lowing order red, green, blue. 

DEVMONORPIXELS: pixels will be stored in pixels, 1 byte to a pixel, with the red com- 
ponent of the pixel actually being stored. 

DEVMONOGPIXELS: pixels will be stored in pixels, 1 byte to a pixel, with the green 
component of the pixel actually being stored. 

DEVMONOBPIXELS: pixels will be stored in pixels, 1 byte to a pixel, with the blue com- 
ponent of the pixel actually being stored. 

DEVMONOAPIXELS: pixels will be stored in pixels, 1 byte to a pixel, with die alpha 
(overlay) component of the pixel actually being stored. 

DEV_MONO_PIXELS: pixels will be stored in pixels, 1 byte to a pixel. This option is only 
available when reading from DEV_ZRAM_BUFFER. 

DEV_M0N0_16_PIXELS: pixels will be stored in pixels, 2 bytes to a pixel. This option is 
only available when reading from DEV_ZRAM_BUFFER. 
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DEVDSPFLOATPIXELS: pixels will be stored in pixels, 4 bytes to a pixel. This option is 
only available when reading from DEV_ZRAM_BUFFER. 

DEVJEEEFLOAT PIXELS: DSP floating point values in ZRAM will be converted to ffiEE 
floating point pixels in ZRAM, then uploaded 4 bytes to a pixel. When the upload operation is 
finished, the IEEE floats in ZRAM will be converted back to DSP floats. This double conver- 
sion can result in rounding errors. This option is only available when reading from 
DEV ZRAM BUFFER. 



c 



The following values are or'ed into the mode argument to specify which portion of Pixel Machine 
memory to upload from: 

DEVFRONTBUFFER: Upload pixels from the front (currently displayed) portion of VRAM. 

DEV_BACK_BUFFER: Upload pixels from the back (currently non- displayed) portion of 
VRAM. 

DEV_VRAMO_BUFFER: Upload pixels from the VRAMO portion of VRAM. 

DEV_VRAM1 BUFFER: Upload pixels from the VRAMl portion of VRAM. 

DEV^ZRAM^BUFFER: Upload pixels from ZRAM. 

The sizes of the above buffers vary depending on the type of Pixel Machine being used as defined in the 
following table: 



Model 


FRONT 


BACK 


VRAMO 


VRAMl 


ZRAM 


916 


1024x1024 


1024x1024 


- 


- 


1024x1024 


920 


1280x1024 


1280x1024 


- 


- 


1280x1024 


932 


1024x1024 


1024x1024 


1024x2048 


1024x2048 


1024x2048 


940 


1280x1024 


1280x1024 


1280x2048 


1280x2048 


1280x2048 


964 


2048x1024 


2048x1024 


2048x2048 


2048x2048 


2048x2048 


964X 


2048x1024 


2048x1024 


2048x2048 


2048x2048 


2048x2048 
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Note that when uploading from ZRAM, the number of ''pixels" per scan line varies with the size of a 
pixel. For example, on a 964, a scan line of DEV MONO PIXELS is 8192 (4*2048) pixels wide, a 
scan Une of DEV__M0N0__16_PIXELS is 4096 (2*2048) pixels wide. 

RETURNS 

DEVget_scaii_line returns upon success and -1 on failure. DEVgetscanJine also sets DEVerrno 
and DEVerrmsg upon failure. If DEVget^scan Jine fails, DEVerrno will be set to one of the follow- 
ing values: 



DEV_ERRJNVPARAMETER: 
invalid. 



one or more of the parameters passed to DEVgetscanJine is 



DEVERRNORESPONSE: DEVgetscanJine sent a system command to the Pixel Machine to 
begin uploading but received no response from the pixel nodes. Typically this means that the pixel 
node programs did not call PMenableO to allow processing of the system command or the system 
command was not passed through the pipe nodes. 



NOTES 



DEVget_scan_line sends a system command to all pixel nodes to initiate uploading of the scan line. 
Pixel node programs must be prepared to receive this command or DEVgetscanJine will fail. The 
pixel node program should call PMenable with the PMENABLEGETSCAN LINE, 



c 
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PM_ENABLE_GET_VRAM or PM^ENABLEGETZRAM argument during its initialization and 
should call PMgetcmd in its main processing loop. PMgetcmd will recognize the system command and 
call the appropriate routine to upload the scan line(s). In addition, the pipe node programs must make 
sure the system command is forwarded through each of the pipe nodes. The PMgetop function will 
transparently pass these system commands through to the pixel nodes. 

DEVgetscanline is an optimized version of DEVgetpixels for operations like image upload and 
image processing. 

DEVgetscanline will be slightly faster if the scan line starts and ends on a subscreen boundary (i.e., 
((jc % DEVx_^scale(system)) == 0) and ((x-¥npixl % DEVx_scale(system)) == 0)). 

SEE ALSO 

DEVget_pixels(3S) 
DEVinitOH) 
PMenable(3N) 
PMgetcmd(3X) 
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NAME 

DEVinit - opens and initializes Pixel Machine device 

SYNOPSIS 

#include <host/devtools.h> 

DEVpixelsystem *DEVinitO 

DESCRIPTION 

DEVinit opens and initializes the device associated with the Pixel Machine. It should always be 
included at the start of any DEVtools host program. 

DEVinit performs the following operations: opens the device, sets global variables that can be used to 
access the system configuration information, halts the processors, resets the processors and configures 
the pipes, and sets the pixel mode register. 

DEVinit handles the signals SIGHUP, SIGINT, and SIGTERM. If any of these signals are received, 
the processors are stopped, the FIFOs are reset, and the pipe is restored to its original configuration. 

DEVinit returns a pointer to the system descriptor if all of the operations complete successfully. If the 
operation fails, it returns NULL. 

SEE ALSO 

DEVopen(3S) 
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NAME 

DEVload_color_tables - reads file of gamma calibration values and sets color lookup tables 

SYNOPSIS 

#include <host/devtools.h> 

void DEVload_color_tables(pixel_system, filename) 
DEVpixelsystem *pixel_system ; 

char * filename; 

DESCRIPTION 

DEVload_color_tables reads a file of gamma calibration values and sets the color lookup tables 
appropriately. The gamma file consists of a series of lines of the format: 

x,x y.y 

Where: 

xjc is a calibration level 

y.y is the measured video output 

DEVload_color_tables computes color table values by interpolating the input values. 

NOTES 

DEVload_color_tables is automatically called by DEVinit and DEVopen when the HYPERGAMMA 
environment variable is set. 

SEE ALSO 

DEVinit(3S) 
DEVopen(3S) 



Pixel Machines Last change: Version 1.1 



DEVlock ( 3S ) DEV tools DEVIock ( 3S ) 



NAME 

DEVlock - manage Pixel Machine locks 

SYNOPSIS 

#include <host/devtools.h> 

int DEVlock(key,device) 
int key; 
DEVpixeldevice *device; 

DESCRIPTION 

DEVlock is used to manage the locks for the Pixel Machine to prevent more than one user from access- 
ing the machine at the same time, key designates the action desired; it must have one of the following 
values: 

DEVKEYLOCKASSIGN: assigns the device to a user 
DEVKEYLOCKJJNASSIGN: clears a previous assignment 
DEVKEYLOCK LOCK: locks the device for a user 
DEV^KEYLOCK__UNLOCK: unlocks the device 

Locking and assigning are similar processes, differing only in that locking has higher precedence. Lock- 
ing is used by the hyplock and hypfree commands, while assigning is used by the DEVopen and DEV- 
close functions. The difference in precedence levels allows a user to lock a system using the hyplock 
command, run one or more programs that use DEVopen and DEVclose and still have the system locked 
upon completion of the programs. This may be useful to avoid having the contents of the screen cor- 
rupted, even after the program that created the image has completed. 
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NAME 

DEVopen, DEVopensystem - make a Pixel machine available to a user program 

SYNOPSIS 

#iiiclude <host/devtools.h> 

DEVpixelsystem *DEVopen() 

DEVpixelsystem *DEVopeii_system(options) 
int options; 

DESCRIPTION 

DEVopen makes a Pixel Machine available to a user program. The environment variables 
HYPERUNIT, HYPER_ADDRESS, HYPER_MODEL, HYPER PIPE HYPERGAMMA, and 
HYPERVIDEO are used to determine which machine is to be used and the configuration of the sys- 
tem. 

If the device is already open, it is closed before DEVopen attempts to reopen it DEVopen looks for a 
lock file for the device being requested. If the device is already locked, DEVopen returns NULL. Oth- 
erwise, a lock file is created to prevent the device from being accessed by another user. 

If the open operation is successful, DEVopen returns a pointer to a system description block, otherwise 
NULL is returned. 

The actual process of opening the device consists of: 

creating a lock file for the desired device 

opening the VME bus device associated with the Pixel Machine designated by the environment 
variable HYPERUNIT 

allocating a memory area that is mapped to the device that has been opened 

initializing a system description block that contains the memory map addresses for each of the 
boards and each of the processors in the Pixel Machine 

configuring the pipes based on the contents of the HYPER_PIPE environment variable 

initializing the pixel mode registers on the pixel boards 

configuring the video controller based on the contents of the HYPERMODEL, 
HYPERGAMMA and HYPERVIDEO environment variables. 

The following system status information is updated by DEVopen: 

- The color tables are updated based on the HYPERGAMMA environment variable. If 
HYPERGAMMA is set and is not null, it is used as the the name of a file that contains a 
gamma correction table. If HYPERGAMMA is not set or is null, a linear ramp is loaded into 
the color tables. If HYPER_GAMMA does not contain an absolute pathname, it is used as a 
filename in the $HYPER_PATH/crts directory. Relative pathnames are not supported. 

- The video control parameters are set based on the HYPER_MODEL and HYPER_VIDEO 
environment variables. The HYPERVIDEO variable contains a string that is parsed to pro- 
duce a value that is passed to DEVset_video_options(). The string in HYPERVIDEO must 
be of the format: 

sync_source= { int , ext } 
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synG_^on__green={on/ of f } V. 

The value after the equal sign must be one of the values listed in braces. The first value is the default; 
spaces in the string are ignored. 

EXAMPLES 

HYPER_yiDeO="sync_sourGe=ext synej)n_jreen=off" 
HYP6R_VlDEO:^"sync_iOurce = int" 

NOTES 

tlEVlliit is ordinarily used instead of DEVopen. DEVopen is provided for users who require lower 
level control of the Pixel Machine. 

DEVopen_Systein is identical to DfiVopen, with the exception that an option paraineter is provided to 
override certain default actions described above. 

options must be zero or the value DEVOPENNOCONFIG. Setting the noconfig option causes 
DEVopensystem to suppress the steps that set the configuration of the machine. The steps omitted 
are: 

- configuring the pipes 

~ initializing the pixel mode registers 

- loading the color tables 

- setting the video options 

The noconfig option is used by commands like devprint and hypstat that need to access the Pixel i 

Machine without altering the mode that the machine is running. 

This function should only be used for applications that require lower level access to the machine. 

SEE ALSO 

DEVload_color_tables(3S) 



<: 
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NAME 

DEVpipeboot - load a Pixel Machine executable into specified set of pipe nodes 

SYNOPSIS 

#include <host/devtools.h> 

int DEVpipebootCpixelsystein, fileiiaine, firstnode, last node, 

loadtable, options) 
DE Vpixelsy stem * pixelsystem ; 

char * filename; 

int firstnode; 

int lastnode; 

int load_table[]; 

int options; 

DESCRIPTION 

DEVpipeboot determines whether the specified Pixel Machine executable file has been loaded into the 
Pixel Machine. If the file has not been loaded, DEVpipeboot loads it into the specified set of nodes. 

pixelsystem is a pointer to the system structure of the system to be loaded, first node and lastjiode 
specify the range of nodes to be loaded. Sti^xng first jtode to DEVALL causes all of the pipe nodes to 
be loaded, loadjable is a pointer to an array of boolean values that indicate for each node whether or 
not the node should be loaded. If first node <= node <= lastjiode and loadjable [node] is true, then 
the node is loaded. The load table feature is supplied to make it possible to load the same program into 
an arbitrary group of nodes while only reading the executable file once. If the load table feature is not 
needed, a null pointer can be used as the argument. 

options is used to specify certain optional processing. This value must be zero or a bitwise or of one or 
more of the following values: 

DEVBOOTVERBOSE: causes a description of the actions being performed to be displayed 

DEVBOOTFORCE: causes the file to always be loaded regardless of the contents of the 
system status file 

DEVBOOTCHECKTIME: causes the modification time of the file to be compared with the 
modification time of the file currently loaded into the node (if the filenames are the same). If 
the times are not the same, the file is reloaded. 

RETURNS 

DEVpipe_boot returns zero if the operation was successful, -1 if an error occurred. The following 
error codes can be generated by DEVpipeboot: 

DEV_ERR_LDFILEOPEN: the specified file could not be opened 
DEV_ERR_LDFILERR: the specified file is not a valid object file 
DEVERROTHER: miscellaneous error while loading the program 
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NAME 

DEVpipeget - read a stream of bytes from the PIR of a pipe DSP 

SYNOPSIS 

#include <host/devtooIs.h> 

int DEVpipegetCpixelsystem, node, buffer, nbytes, timeout) 

DEVpixelsystem *pixel_system; 

int node; 

DEVbyte ^buffer; 

int nbytes; 

int timeout; 

DESCRIPTION 

DEVpipeget reads a stream of bytes from the PIR of a pipe DSP. This function differs from 
DEVpiperead in that it requires a program running on the DSP to load data into the PIR register. The 
implementation differs in that: 

it does not use DMA 

the address from which the data is to be read cannot be supplied 

a timeout parameter must be supplied 

pixel_system is a pointer to the system descriptor, node is the number of the pipe node from which the 
data is to be read, buffer points to the location into which the data is to be read, nbytes is the numba 
of bytes of data to be read, nbytes should always be an even number. If nbytes is odd, nbytes-k-l bytes 
of data will be read, timeout contains the number of times, for each two bytes transferred, that the PCR 
register is to be tested to see if the data has been sent successfully. 

No byte order translation is performed. The data read will be in the same byte order as it is in the DSP 
memory. 

As a result of this operation, the parallel communications modes are altered to set the interrupt vector to 
16~bit mode. 



NOTES 



DEVpipe_get returns the number of characters read. 

The timeout parameter contains the number of loop iterations to be attempted before giving up. Because 
the execution rate depends on the system load, this could yield different results und^ different system 
load conditions. Also, because there is no sleep involved, the host process could consume a great deal 
of CPU time if the delay for each character is significant 
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NAME 

DEVpipe_get_msg - read a message from the PER of a pipe DSP 

SYNOPSIS 

#include <host/devtools.h> 

int DEVpipe_get_msg(pixel_systein, node, buffer, nbytes, swap) 

DEYpixelsystem *pixel_system; 

int node; 

DEVbyte *buffer; 

int nbytes; 

int swap; 

DESCRIPTION 

DEVpipe_get_msg reads a message from the PIR of a pipe DSP. This function is similar to 
DEVpipeget with the following exceptions: 

a timeout parameter is not supplied 

a byte swapping parameter is provided to allow mapping of DSP values into host values 

Like DEVpipeget, DEVpipegetmsg does not use DMA and requires that a program running on the 
DSP load the data into the PIR. 

pixel jystem is a pointer to the system descriptor, node is the number of the pipe node from which the 
data is to be read, buffer points to the location into which the data is to be read, nbytes is the number 
of bytes of data to be read, nbytes should always be an even number. If nbytes is odd, nbytes-^l bytes 
of data will be read, swap must be one of the following values: 

DEVSWAPNONE -■ no byte order conversion 

DEV^SWAPSHORT - the buffer is treated as a collection of 2-byte values and the 
bytes are ordered as required 

DEVSWAPLONG - the buffer is treated as a collection of 4-byte values and the bytes 
are ordered as required. 

If swap is DEV__SWAP_LONG, nbytes should be a multiple of 4, because a multiple of 4 bytes will 
always be read. 

As a result of this operation, the parallel communications modes are altered to set the interrupt vector to 
16-bit mode. 

NOTES 

DEVpipe_get_msg returns the number of characters read. 

This routine will hang and use a lot of CPU time if the process on the DSP does not load the expected 
data into the PIR. 
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NAME 

DEVpipe_get_pir - read the PIR register of a pipe DSP 

SYNOPSIS 

#include <host/devtools.h> 

DEVushort DEVpipe_get_pir(pixel_system,node) 
DEVpixelsystem *pixel_system 
int node; 

DESCRIPTION 

DEVpipe_get_pir reads the PIR register of a pipe DSP. This function is a special version of 
DEVpipegetmsg that always fetches two bytes wiUiout adjusting the byte order. 

Like DEVpipegetmsg, DEVpipegetpir does not use DMA and it requires that a program running 
on the DSP load the PIR. 

pixeljystem is a pointer to the system descriptor, node is the number of the pipe node from which the 
data is to be read. 

As a result of this operation, the parallel communications modes are altered to set the interrupt vector to 
16-bit mode. 

DEVpipe_getj)ir returns the contents of the DSP's PIR register as an unsigned short integer. 

NOTES 

This routine will hang and use a lot of CPU time if the process on the DSP does not load the expected 
data into the PIR. 
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NAME 

DEVpixelhalt - halt a pixel node processor 

SYNOPSIS 

#include <host/devtools.h> 

int DEVpixel_halt(pixel_system,node) 
DEVpixelsystem *pixel_system; 
int node; 

DESCRIPTION 

DEVpixel_halt halts a pixel node processor. After the processor has halted, the parallel communica- 
tions modes are altered to: 

enable interrupts 

enable DMA 

set PAR to be autoincremented on DMA 

set the interrupt vector to 16-bit mode 

RETURNS 

DEVpixel_halt returns DEV^ERROK if the operations succeeds, DEV_ERR_FAIL otherwise. 
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NAME 

DEVpixelidcheck - check status of node's ID 

SYNOPSIS 

#include <host/devtools.h> 
#include <host/crt0.h> 

int DEVpixeI_id_check(systein,node,id) 
DEVpixelsystem *system; 
int node; 
DEVcrtO id *id; 

DESCRIPTION 

DEVpixe!_id_check is used to check whether a node's ID has been corrupted, 

system is a pointer to the system description information returned by DEVopen. node is the number of 
the node to which the ID is to be written, and is also used as a node identification number. 

DEVplxel idcheck uses the parameter id to return the node ID information to the caller, id is a 
pointer to a node identification block. 

RETURNS 

This function returns DEVERROK if the operation is successful, otherwise an error value is returned. 
The possible error values are: 

DEVERR ID: Node ID information is invalid 
DEVERR NODE: Node number is invalid 

SEE ALSO 

DEVpixel_read(3S) 
DEVpixel_write(3S) 
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NAME 



DEVpixel_id_print - read and print the node ID of a processor 



SYNOPSIS 

#include <host/devtools.h> 
#indude <host/crt0.h> 

int DEVpixel_id_prmt(system,node,id) 
DEVpixeisystem *system; 
int node; 
DEVcrtOid *id; 

DESCRIPTION 

DEVpixelJdjprint reads and prints the node ID of a processor's memory, and the node status informa- 
tion from the system status file and displays the information on standard output. DEVpixelidprint 
reads the node ID from a processor and displays the information on standard output. 

system is a pointer to the system descriptor, node is the number of the node to which the ID is to be 
written and is also used as a node identification number. 

The checksum information in the node is compared with the value stored in the system status file on the 
host. If the checksum values do not match the message Node checksum does not match is printed 
beneath the program name. 

This function returns DEV_ERR_OK if the operation is successful, otherwise an error value is returned. 
The possible error values are: 

DEVERRJD: Node ID information is invalid 
DEVERRNODE: Node number is invalid 

EXAMPLE 

Pixel node identification data: 



node id: 





crtO format: 


DEVtools 


X nodes : 


5 


y nodes : 


4 


X offset: 





y offset: 





program: 


/usr/xyz/prog.dsp 


semaphore: 





SEE ALSO 




DEVpixel write(3S) 




DEVpixel read(3S) 
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NAME 

DEVpipejput - write a block of data to a pipe DSP's PDR register 

SYNOPSIS 

#include <host/devtools.h> 

int DEVpipe_put(pixel_system, node, buffer, nbytes, timeout) 

DEVpixelsystem *pixel_system; 

int node; 

DEVbyte *buffer; 

int nbytes; 

int timeout; 

DESCRIPTION 

DEVpipe_put writes a block of data to a pipe DSP's PDR register. This function differs from 
DEVpipewrite in that it requires a program running on the DSP to read data from the PDR register 
and store it in the appropriate memory location. The implementation differs in that: 

it does not use DMA 

the address to which data is to be sent is not supplied 

a timeout parameter must be supplied 

pixel_system is a pointer to the system descriptor, node is the number of the pipe node from which the 
data is to be written, buffer points to the data to be sent, nbytes is the number of bytes of data to be 
written, nbytes should always be an even number. If nbytes is odd, nbytes+l bytes of data will be writ- 
ten, timeout contains the number of times, for each two bytes transferred, that the PCR register is to be 
tested to see if the data has been sent successfully. 

No byte order translation is performed. The data sent will be in the same byte order as it is in buffer. 

As a result of this operation, the parallel communications modes are altered to: 

disable DMA 

set PAR to not be autoincremented on DMA 

set the interrupt vector to 16-bit mode. 



NOTES 



DEVpipe_put returns the number of characters written. 

The timeout parameter contains the number of loop iterations to be attempted before giving up. Because 
the execution rate depends on the system load, this could yield different results under different system 
load conditions. Also, because there is no sleep involved, the host process could consume a great deal 
of CPU time if the delay for each character is significant. 
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NAME 

DEVpiperun - begin execution of programs loaded into specified pipe nodes 

SYNOPSIS 

#inciude <host/devtools.h> 

void DEVpipe_run(pixeI_system, firstnode, lastnode, options) 
DE Vpixelsystem * pixelsystem ; 

int firstnode; 

int lastnode; 

int options; 

DESCRIPTION 

DEVpipe_run begins execution of the programs loaded into the specified pipe nodes. 

pixel_system is a pointer to the system structure of the system whose node is to be started, firstjtode 
and lastjiode specify the range of nodes. 

options is used to specify certain optional processing. This value should be zero or the value 
DEV_RUN_VERBOSE, which causes DEVpipe_run to provide additional information. 

RETURNS 

DEVpiperun returns zero if execution was started successfully, - 1 if an error occurred. The following 
error code can be generated by DEVpiperun: 

DEV_ERR_STARTERR: the program loaded in the node could not be started 

NOTES 

DEVrun can be used to begin execution on all pipe and pixel nodes. 

SEE ALSO 

DEVrun(3H) 



Pixel Machines Last change: Version 1.1 



DE Vpipe_write ( 3S ) DEVtools DEVpipe_write ( 3S ) 



NAME 

DEVpipe_write - write a buffer to a pipe DSP 

SYNOPSIS 

#include <host/devtools.h> 

int DEVpipe_write(pixel_system, node, addr, buffer, nbytes) 

DEVpixelsystem *pixel_system; 

int node; 

DEVushort addr; 

DEVbyte *buffer; 

Int nbytes; 

DESCRIPTION 

DEYpipe_write writes a buffer to a pipe DSP. The data is transferred using parallel DMA. 

pixel_system is a pointer to the system descriptor, node is the number of the pipe node from which the 
data is to be written, addr is the location in the DSP address space to which the data is to be sent. 
buffer points to the data to be sent, nbytes is the number of bytes of data to be written, nbytes should 
always be an even number. If nbytes is odd, nbytes-^1 bytes of data will be written. 

The data sent will be in the same byte order as it is in buffer. No byte order translation is performed. 

DEVpipe_write uses parallel DMA I/O to transfer the data. As a result, the parallel control register is 
updated by this routine. The parallel communications modes are altered to: 

enable DMA 

set PAR to be autoincremented on DMA 

set the interrupt vector to 16 bit mode 

RETURNS 

DEVpipewrite should always return zero. 

If nbytes is odd, DEVpipe_write will write nbytes+l bytes of data and return -1 as its return value. The 
return value should probably be the number of bytes written, not zero. 
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NAME 

DEVpixel_boot - load a Pixel Machine executable into specified set of pixel nodes 

SYNOPSIS 

#indude <host/devtooIs.h> 

int DEVpixel_boot(pixel_system, filename, firstnode, lastnode, 

loadtable, options) 
DE Vpixelsystem * pixelsystem ; 

char * filename; 

int firstnode; 

int lastnode; 

int loadtablell; 

int options; 

DESCRIPTION 

DEVpixel_boot determines whether the specified Pixel Machine executable file has been loaded into the 
Pixel Machine, If the file has not been loaded, DEVpixelboot loads it into the specified set of nodes. 

pixel_system is a pointer to the system structure of the system to be loaded, first jtode and lastjwde 
specify the range of nodes to be loaded. If first jiode is set to DEVALL, all pixel nodes will be 
loaded, loadjable is a pointer to an array of boolean values that indicate for each node whether or not 
the node should be loaded. If first jiode <= node <= lastjwde and loadjable[node] is true, then the 
node is loaded. The load table feature is supplied to make it possible to load the same program into an 
arbitrary group of nodes, while only reading the executable file once. If the load table feature is not 
needed, a null pointer can be used as the argument. 

options is used to specify certain optional processing. This value must be zero or a bitwise or of one or 
more of the following values: 

DEVBOOTVERBOSE: causes a description of the actions being performed to be displayed 

DEVBOOTFORCE: causes the file to always be loaded regardless of the contents of the 
system status file 

DEVBOOTCHECKTIME: causes the modification time of the file to be compared with the 
modification time of the file currently loaded into the node (if the filenames are the same). If 
the times are not the same, the file is reloaded. 

RETURNS 

DEVpixeI_boot returns zero if the operation was successful, - 1 if an error occurred. The following 
error codes can be generated by DEVpixelboot: 

DEV_ERR_LDFILEOPEN: the specified file could not be opened 
DEVERRLDFILERR: the specified file is not a valid object file 
DEVERROTHER: miscellaneous error while loading the program 
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NAME 

DEVpixelbuffer - selects the frame buffer to be displayed 

SYNOPSIS 

#include <host/devtools.h> 
#include <host/pixeLh> 

void DEVpixel_buffer(system,buffer) 
DEVpixelsystem *systein; 
DEVushort buffer; 

DESCRIPTION 

DEVpixelbuffer selects the frame buffer to be displayed. 

system is a pointer to the system description information returned by DEVopeu. bujfer indicates which 
frame buffer is to be displayed, and must be one of the following values: 

DEV_VBU FO: Display frame buffer 

DEV_VBUF1 : Display frame buffer 1 

NOTES 

Because this function updates the pixel node flag registers, it should only be used when the Pixel 
Machine is halted. 
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NAME 

DEVpixel_get - read a stream of bytes from a pixel DSP's PIR register 

SYNOPSIS 

#inclu(ie <host/devtools.h> 

int DEVpixel_get(pixel_system, node, buffer, nbytes, timeout) 

DEVpixelsystem *pixel_system; 

int node; 

DEVbyte *buffer; 

int nbytes; 

int timeout; 

DESCRIPTION 

DEVpixelget reads a stream of bytes from a pixel DSP's PIR register. This function differs from 
DEVpixel_read in that it requires a program running on the DSP to load data into tlie PIR register. 
The implementation differs in that: 

it does not use DMA 

the address from which the data is to be read cannot be supplied 

a timeout parameter must be supplied 

pixel_jystem is a pointer to the system descriptor, node is the number of the pixel node from which the 
data is to be read, buffer points to the location into which the data is to be read, nbytes is the number 
of bytes of data to be read, nbytes should always be an even number. If nbytes is odd, nbytes-¥l bytes 
of data will be read, timeout contains the number of times, for each two bytes transferred, that the PCR 
register is to be tested to see if the data has been sent successfully. 

No byte order translation is performed. The data read will be in the same byte order as it is in the DSP 
memory. 

As a result of this operation the parallel communications modes are altered to set the interrupt vector to 
16-bit mode. 

RETURNS 

DEVpixel_get returns the number of characters read. 

NOTES 

The timeout parameter contains the number of loop iterations to be attempted before giving up. Because 
the execution rate depends on the system load, this could yield different results under different system 
load conditions. Also, because there is no sleep involved, the host process could consume a great deal 
of CPU time if the delay for each character is significant. 
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NAME 

DEVpixelgetmsg - read a message from a pixel DSP's PIR register 

SYNOPSIS 

#mclude <host/devtools.h> 

int DEVpixelgetmsgCpixelsystenij node, buffer, nbytes, swap) 

DEVpixelsystem *pixel_system; 

int node; 

DEVbyte *buffer; 

int nbytes; 

int swap; 

DESCRIPTION 

DEVpixel_get_msg reads a message from a pixel DSP's PIR register. This function is similar to 
DEVpixelget with the following exceptions: 

a timeout parameter is not supplied 

a byte swapping parameter is provided to allow mapping of DSP values into host values 

Like DEVpixel_get, DEVpixelgetmsg does not use DMA and requires that a program running on the 
DSP load the data into the PIR. 

pixeljsystem is a pointer to the system descriptor, node is the number of the pixel node from which the 
data is to be read, buffer points to the location into which the data is to be read, nbytes is the number 
of bytes of data to be read, and it should always be an even number. If nbytes is odd, nbytes+l bytes of 
data will be read, swap must be one of the following values: 

DEV^SWAPNONE: 

no byte order conversion 

DEVSWAPSHORT: 

the buffer is treated as a collection of 2-byte values and the bytes are ordered as required 

DEV^SWAPLONG: 

the buffer is treated as a collection of 4-byte values and the bytes are ordered as required. 

If swap is DEV_SWAP_LONG, nbytes should be a multiple of 4 because a multiple of 4 bytes will 
always be read. 

As a result of this operation, the parallel communications modes are altered to set the interrupt vector to 

16-bit mode. 
RETURNS 

DEVpixelgetmsg returns the number of characters read. 
NOTES 

This routine will hang and use a lot of CPU time if the process on the DSP does not load the expected 

data into the PIR. 
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DEVpixel_get jpir ( 3S ) DEVtools DEVpixel_get_pir ( 3S ) 



NAME 

DEVpixel_getj)ir - read the PIR register of a pixel DSP 

SYNOPSIS 

#include <host/devtools.h> 

DEVushort DEVpixel_get_pir(pixel_system,node) 
DEVpixelsystem *pixel_systein; 
int node; 

DESCRIPTION 

DEVpixelgetjpir reads the PIR register of a pixel DSP. This function is a special version of 
DEVpixel_get_msg, and it always fetches two bytes without adjusting the byte order. 

Like DEVpixelgetmsg, DEVpixelgetpir does not use DMA and it requires that a program running 
on the DSP load the PIR. 

pixeljystem is a pointer to the system descriptor, node is the number of the pixel node from which the 
data is to be read. 

As a result of this operation, the parallel communications modes are altered to set the interrupt vector to 
16-bit mode. 

DEVpixel_getjpir returns the contents of the DSP's PIR register as an unsigned short integer. 

NOTES 

This routine will hang and use a lot of CPU time if the process on the DSP does not load the expected 
data into the PIR. 
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NAME 

DEVpipe_halt - halt a pipe node processor 

SYNOPSIS 

#include <host/devtools.h> 

int DEVpipe_halt(pixel_system,node) 
DEVpixelsystem *pixel_system; 
int node; 

DESCRIPTION 

DEVpipe_halt halts a pipe node processor. After the processor has halted, the parallel communications 
modes are altered to: 

enable interrupts 

enable DMA 

set PAR to be autoincremented on DMA 

set the interrupt vector to 16-bit mode 



NOTES 



DEVpipe^halt returns DEV_ERR_OK if the operations succeeds, DEV_ERR_FAIL otherwise. 
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NAME 

DEVpipe_id_check - check status of node's ID 

SYNOPSIS 

#include <host/devtools.h> 
#iiiclude <host/crt0.h> 

int DEVpipe_id_check(systein,node,id) 
DEVpixelsystem *system; 
int node; 
DEVcrtOid *id; 

DESCRIPTION 

DEVpipe_id_check is used to check whether a node's ID has been corrupted. 

system is a pointer to the system description information returned by DEVopen. node is the number of 
the node to which the ID is to be written and is also used as a node identification number. 

DEVpipeidcheck uses the parameter id to return the node ID information to the caller, id is a pointer 
to a node identification block. 

This function returns DEV_ERR_OK if the operation is successful, otherwise an error value is returned. 
The possible error values are: 

DEVERRJD: Node ID information is invalid 
DEVERRNODE: Node number is invalid 

SEE ALSO 

DEVpipe_write(3S) 
DEVpipe read(3S) 
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NAME 

DEVpipe_id_print - read and print the node ID of a processor 

SYNOPSIS 

#include <host/devtools.h> 
#include <host/crt0.h> 

int DEVpipe id_print(system,iiode,id) 
DEVpixelsystem *system; 
int node; 
DEVcrtOid *id; 

DESCRIPTION 

DEYpipe_idj)rint reads the node ID from the processor's memory and the node status information 
from the system status file, and displays the information on standard output. DEVpipe idprint reads 
the node ID from a processor and displays the information on standard output. 

system is a pointer to the system descriptor, node is the number of the node to which the ID is to be 
written and is also used as a node identification number. 

The checksum information in the node is compared with the value stored in the system status file on the 
host. If the checksum values do not match, the message Node checksum does not match is printed 
beneath the program name. 

This function return DEV_ERR_OK if the operation is successful, otiierwise an error value is returned. 
The possible error values are: 

DEV ERRJD: Node ID information is invalid 
DEV ERR NODE: Node number is invalid 



EXAMPLE 




Pipe node identification data: 


node id: 





crtO format: 


DEVtools 


X nodes : 


5 


y nodes : 


4 


X offset: 





y offset: 





program: 


/usr/xyz/prog.dsp 


semaphore: 





SEE ALSO 




DEVpipe write(3S) 




DEVpipe read(3S) 
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NAME 

DEVpixel_id_write - write a node id block to a reserved location in a pixel node DSP's memory 

SYNOPSIS 

#include <host/devtools.h> 
#in€lude <host/crt0.h> 

int DEVpixel_id_write(system,node,name) 
DEVpixelsystem *system; 
int node; 
char *name; 

DESCRIPTION 

DEVpixelidwrite writes a node identification block to a reserved location in pixel node memory. The 
memory used to hold the node ID is allocated by the routine crtO, therefore pixelcrtO.O must be linked 
as part of the executable code running on the processor in order to use DEVpixe!_id_write. 

system is a pointer to the system description information returned by DEVopen. node is the number of 
the node to which the ID is to be written, and is also used as a node identification number, name is a 
pointer to the name that is to be assigned to the node. 

RETURNS 

This function returns DEVERROK if the operation is successful, otherwise an error value is returned. 
The possible error values are: 

DEVERRJD: Node ID information is invalid 
DEVERRNODE: Node number is invalid 

SEE ALSO 

DEVpixel write(3S) 
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NAME 

DEVpixel_mode init - initialize pixel board mode register 

SYNOPSIS 

#mclude <host/devtools.h> 

void DEVpixelmode iiiit(system,omode) 
DEVpixelsystem *system; 
DEVpixelmodereg omode; 

DESCRIPTION 

DEVpixel_mode_init sets overlay mode and initializes the gate bits, video shift rate, and the serial I/O 
connector selection fields in the pixel mode register on each pixel node board. A copy of the pixel 
mode register is maintained on the host because the board's pixel mode register cannot be read. As a 
result, DEVpixel_mode_iiiit must be called during the initialization process, otherwise when a call is 
made that updates the pixel mode register (DEVserialdirection for example), it will load the register 
with an uninitialized value. 

system is a pointer to the system description information returned by DEVopen. omode must contain 
one of the following values: 

DEV OVERLAYOFF: Uses the values in rgb 

DEVOVERLAYON: If any overlay bit is on, the overlay value is used for the 

red, green, and blue values. If all of the overlay bits are on, the inverse of rgb is used. 

DEV_OVERLAY_FORCE: The overlay value is always used. 

DEV^OVERLAY MASK: If overlay bit 7 is on, the overlay value 
is used for red, green, and blue; otherwise rgb is used. 

DEVpixel_inode_iiiit initializes the other components of the pixel mode register to default values. The 
defaults are: 

Mode Bits - DEV^GATES_SYNC | DEV_GATES_FIFO 

Video shift rate - Appropriate value based on the system type 

Serial I/O - Serial I/O connector/direction zero selected 
NOTES 

In order for overlaying to be performed, the overlay flags must be set in both pixel node boards' pixel 

mode registers and in the individual processor's flag registers. 
SEE ALSO 

DEVpixel overlayOS) 

PMoverlay(3X) 



Pixel Machines Last change: Version 1.1 
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NAME 

DEVpixel_mode_overlay - set overlay mode in the pixel mode register 

SYNOPSIS 

#mclude <host/devtools.h> 

void DEVpixel_mode_overlay(system,omode) 
DEVpixelsystem *system; 
DEVpixelmodereg omode; 

DESCRIPTION 

DEVpixelmodeoverlay sets the overlay mode in the pixel mode register of each pixel node board. 
Other fields of the pixel mode register are not affected. 

system is a pointer to the system description information returned by DEVopen. omode must contain 
one of the following values: 

DEV_OVERLAY_OFF: Uses the values in rgb 

DEVOVERLAYON: If any overlay bit is on, the overlay value 

is used for the red, green, and blue values. If all of the overlay bits are on, the inverse of 
rgb is used. 

DEVOVERLAYFORCE: The overlay value is always used. 

DEVOVERLAYMASK: If overlay bit 7 is on, the overlay value 
is used for red, green, and blue; otherwise rgb is used. 

NOTES 

In order for overlaying to be performed, the overlay flags must be set in both the pixel node boards' 
pixel mode register and in the individual processor's flag registers. 
SEE ALSO 

DEVpixd_overlay(3S) 
PMoverlay(3X) 
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NAME 

DEYpixel_overlay - update overlay mode in all pixel processor's flag registers 

SYNOPSIS 

#include <host/devtools.h> 
#include <host/pixel.h> 

void DEVpixel_overlay(system,mode) 
DEVpixelsystem ^system; 
DEVushort mode; 

DESCRIPTION 

DEVpixel_overlay updates the overlay mode associated with each of the individual pixel processor's 
flag registers. The overlay mode must be set both in the pixel node board's pixel mode register and for 
the individual processors. 

system is a pointer to the system description information returned by DEVopen. mode contains the new 
contents of the overlay flag and must be one of the following values: 

DEVOVERLAY: Set the overlay flag 

(zero): Clear the overlay flag 
NOTES 

Because this function updates the pixel node flag registers, it should only be used when the Pixel 
Machine is halted. 

The PMoverlay function should be used to set the overlay mode during execution. 
SEE ALSO 

PMoverlay(3X) 
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NAME 

DEVpixel_put - send a block of data to a pixel DSP's PDR register 

SYNOPSIS 

#include <host/devtools.h> 

int DEVpixeljput(pixel_system, node, buffer, nbytes, timeout) 

DEVpixelsystem *pixel_system; 

int node; 

DEVbyte *buffer; 

int nbytes; 

int timeout; 

DESCRIPTION 

DEVpixel_put sends a block of data to a pixel DSP's PDR register. This function differs from 
DEVpixel_write in that it requires that a program running on the DSP read data from the PDR register 
and store it in the appropriate memory location. The implementation differs in that: 

it does not use DMA 

the address to which data is to be sent is not supplied 

a timeout parameter must be supplied 

pixel_system is a pointer to the system descriptor, node is the number of the pixel node from which the 
data is to be written, bujfer points to the data to be sent, nbytes is the number of bytes of data to be 
written, nbytes should always be an even number. If nbytes is odd, nbytes-k-l bytes of data will be writ- 
ten, timeout contains the number of times, for each two bytes transferred, that the PCR register is to be 
tested to see if the data has been sent successfully. 

No byte order translation is performed. The data sent will be in the same byte order as it is in bujfer. 

As a result of this operation, the parallel communication modes are altered to: 

disable DMA 

set PAR to not be autoincremented on DMA 

set the interrupt vector to 16-bit mode 

RETURNS 

DEVpixel_put returns the number of characters written. 



NOTES 



The timeout parameter contains the number of loop iterations to be attempted before giving up. Because 
the execution rate depends on the system load, this could yield different results under different system 
loadconditions. Also, because there is no sleep involved, the host process could consume a great deal of 
CPU time if the delay for each character is significant. 
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NAME 

DEVpixel_read - read a block of memory from a pixel DSP 

SYNOPSIS 

#include <host/devtools,h> 

int DEVpixel_read(pixel_system, node, addr, buffer, nbytes) 

DEVpixelsystem *pKel_system; 

int node; 

DEVushort addr; 

DEVbyte *buffer; 

int nbytes; 

DESCRIPTION 

DEVpixel_read reads a block of memory from a pixel DSP. The data is retrieved from DSP memory 
using parallel DMA. 

pixel jrystem points to the system descriptor, node is the number of the pixel node from which the data 
is to be read, addr is the location in the DSP address space that contains the data to be read, addr must 
be an even memory location, aligned on a 16-bit word boundary, buffer points to the location into 
which the data is to be read, nbytes is the number of bytes of data to be read, nbytes should always be 
an even number. If nbytes is odd, nbytes+l bytes of data will be read. 

No byte order translation is performed. The data read will be in the same byte order as it is in the DSP 
memory. 

DEVpixel_read uses parallel DMA I/O to transfer the data. As a result, the parallel control register is 
updated by this routine. The parallel communications modes are altered to: 

enable DMA 

set PAR to be autoincremented on DMA 

set the interrupt vector to 16-bit mode 

RETURNS 

DEVpixel_read should always return zero. 

If nbytes is odd, DEVpixelread reads nbytes+l bytes of data and returns -1 as its return value. The 
return value should be the number of bytes written, not zero. 

SEE ALSO 

DEVpixel_get(3S) 
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NAME 

DEVpixel_run - begin execution of programs loaded into specified pixel nodes 

SYNOPSIS 

#include <host/devtools.h> 

void DEVpixel_ruii(pixel_system, firstnode, lastnode, options) 
DEVpixelsystem *pixel_system ; 

int firstnode; 

int lastnode; 

int options; 

DESCRIPTION 

DEVpixel_run begins execution of the programs loaded into the specified pixel nodes. 

pixel_system is a pointer to the system structure of the system whose node is to be started, first jiode 
and lastjiode specify the range of nodes. 

options is used to specify certain optional processing. This value should be zero or the value 
DEVRUNVERBOSE, which will cause DEVpixelrun to provide additional information. 

RETURNS 

DEVpixelrun returns zero if execution started successfully, - 1 if an error occurred. The following 
error code can be generated by DEVpixelrun: 

DEVERRSTARTERR: the program loaded in the node could not be started 

NOTES 

DEVrun can be used to begin execution on all pipe and pixel nodes. 
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NAME 

DEVpixel^system DEVpipe_^nodes, DEVlastj)ipe, DEVpixel nodes, DEVlastjpixel, DEVx nodes, 
DEVynodes, DEVxscale, DEVyscale, DEVxscreen, DEVy_screen, DEVmodelcode, 
DEVvideocode, DEVpipecode - macros used to fetch system description information from the sys- 
tem descriptor 

SYNOPSIS 

#include <host/devtools.h> 

int DEYpipe_nodes(pixel_system) 
DEVpixelsystem *pixel_system; 

int DEVlastjpipe(pixel_system) 
DEVpixel_system *pixel_system; 

int DEVpixel_nodes(pixel_system) 
DEVpixelsystem *pixel_system; 

int DEVlastj)ixel(pixel_system) 
DEVpixelsystem *pixel_system; 

int DEVx_nodes(pixel_system) 
DEVpixelsystem *pixel_system; 

int DEVy_nodes(pixel_system) 
DEVpixelsystem *pixel_system; 

int DEVx_scale(pixel_system) 
DEVpixelsystem *pixel_system; 

int DEVy_scale(pixel_system) 
DEVpixelsystem *pixel_system; 

int DEVx_screen(pixel_system) 
DEVpixel_system *pixel_system; 

int DEVy_screen(pixel_system) 
DEVpixelsystem *pixel_system; 

DEVushort DEVmodel_code(pixel_system) 
DEVpixelsystem *pixel_system; 

DEVushort DEVvideo_code(pixel_system) 
DEVpixelsystem *pixel_system; 

DEVushort DEVpipe_code(pixel_system) 
DEVpixelsystem *pixel_system; 

DESCRIPTION 

These macros are used to fetch system description information from the system descriptOT. These mac- 
ros should always be used to access this information. Direct use of the fields of the system structure is 
unsupported. 
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DEVpixel system ( 3S ) DEVtools DEVpixel_^system ( 3S ) 

The following describes the value returned by each macro: \ 

DEVpipenodes: the number of pipe node processors (0, 9, or 18). 

DEVIast_pipe: the number of the last pipe node. Useful for calling routines such as DEVpollnodes. 

DEVpixel_nodes: the number of pixel node processors (16, 20, 32, 40, or 64). 

DEVIast_pixel: the number of the last pixel node. Useful for calling routines such as DEVpollnodes. 

DEVx_nodes: the number of nodes in the X dimension (4, 5, 8, or 10) 

DEVy_nodes: the number of nodes in the Y dimension (4 or 8) 

DEVxscale: the number of virtual nodes in the X dimension (8, or 10) 

DEVyscale: the number of virtual nodes in the Y dimension (8) 

DEVxscreen: the screen width in pixels 

DEVyscreen: the screen hight in pixels 

DEVmodel_code: the system model 
DEV^MODEL_916 

DEV_MODEL_920 f^ 

DEV^MODEL__932 ^ 

DEV__MODEL_940 
DEV_^MODEL_964 
DEV^MODEL__964X 

DEVvideo_code - the video mode in use 
DEV__MODEL^VIDEO^HIRES 
DEV MODEL^VIDEO_NTSC 
DEVMODEL VIDEO__PAL 

DEVpipecode - the pipe mode in use 
DEV^MODEL PIPE_SiNGLE 
DEV_MODEL_PIPE_^PARALLEL 
DEV^MODEL__PIPE_SERIAL 
DEV MODEL PIPE NONE 



c 
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NAME 

DEVpixel_write - write a buffer to a pixel DSP 

SYNOPSIS 

#iiiclude <host/devtools.h> 

int DEVpixel_write(pixel_system, node, addr, buffer, nbytes) 

DEVpixelsystem *pixel_system; 

int node; 

DEVushort addr; 

DEVbyte *buffer; 

int nbytes; 

DESCRIPTION 

DEVpixelwrite writes a buffer to a pixel DSP. The data is transferred using parallel DMA. 

pixeljystem is a pointer to the system descriptor, node is the number of the pixel node from which the 
data is to be written, addr is the location in the DSP address space to which the data is to be sent, addr 
must be an even memory location, aligned on a 16-bit word boundary, buffer points to the data to be 
sent nbytes is the number of bytes of data to be written, nbytes should always be an even number. If 
nbytes is odd, nbytes-\-\ bytes of data will be written. 

No byte order translation is performed. The data sent will be in the same byte order as it is in buffer. 

DEVpixelwrite uses parallel DMA I/O to transfer the data. As a result, the parallel control register is 
updated by this routine. The parallel communications modes are altered to: 

enable DMA 

set PAR to be autoincremented on DMA 

set the interrupt vector to 16-bit mode 

RETURNS 

DEVpixelvirite should always return zero. 

If nbytes is odd, DEVpixelwrite writes nbyteS'¥l bytes of data and returns -1 as its return value. The 
return value should be the number of bytes written, not zero. 
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NAME 

DEVpoU nodes - poll DSP processors for messages 

SYNOPSIS 

#include <host/devtooIs.h> 

int DEVpoll_nodes(pixel_system, firstpipe, lastpipe, firstpixel, lastpixel, itercnt, sleep) 

DEVpixelsystem *pixel_system; 

int firstpipe, lastpipe; 

int firstpixel, lastpixel; 

int itercnt; 

int sleep; 

DESCRIPTION 

DEVpoUnodes is used to poll one, several, or all of the DSP processors to see if they have a user ot 
system message lo be served. DEVpolInodes must be called if the user has calls to printf, 
FMusermsg, FMsiodir or PMhostexit, in a pipe or pixel node program. 

firstpipe and lastpipe are the node numbers of the lowest and highest pipe node processors to be polled. 
firstpixel and lastpixel are the node numbers of the lowest and highest pixel node processors to be 
polled. The lowest node on a system is always zero; the highest number is the number of nodes minus 
one. If either the pipe or pixel nodes are not to be polled, DEVNONE should be supplied for both the 
first and last values. 

iterjont is the number of times the designated processors are to be polled. If itercnt is 
DEV_FOREVER, the polling process continues until an exit message is sent from one of the polled 
processors or until the host program is interrupted. An exit message can be sent from a processor by 
calling the PMhostexit function. 

sleep is the amount of time to sleep between each time the processors are polled. All of the processors 
are polled before the system sleeps. If sleep is DEVNONE, no sleep call is made. The sleep value is 
passed to the usleep system call. DEVNONE should only be used for applications that require very 
fast response to Pixel Machine message requests because it causes the host to consume a large amount 
of CPU time. 

RETURNS 

DEVpoU_nodes returns after all of the specified processors have been polled iter_cnt times, or when an 
exit message is received from any of the polled nodes. The return value is 1 if an exit message was 
received, if the specified number of iterations have been completed. 

EXAMPLE 

#include <host/devtools .h> 



main () 
{ 



if ((DEVinitO == NULL) ) { 

exit (1) ; 
} 

DEVrun (DEVsystem) ; 
DEVpoll_nodes (DEVsystem^ 0, DEVlast_j)ipe (DEVsystem) , 

0, DEVlast_pixel{DEVsystem) , DEV__FOREVER, DEV_NONE) ; 
DEVexit ( ) ; 
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DE VpoUnodes ( 3H ) DEV tools DEVpoUnodes ( 3H ) 



SEE ALSO 

DEVexit(3H) 

DEViiiit(3H) 

PMhost exit(3N) 

printfON) 

PMusermsg(3N) 

PMsiodir(3X) 

usleep(2) on the host system 



c 



c 
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NAME 

DEVputcolormap - update color tables from video controller board and return the value 

SYNOPSIS 

#include <host/devtools.h> 

void DEVput_colorjmap(pixel_systeni, r, g, b) 
DEVpixelsystem *pixel_system ; 

int r[DEV VIDEO TABLE]; 

int g[DEV_VIDEO TABLE]; 

int b[DEV VIDEO^TABLE]; 

DESCRIPTION 

DEVputcolormap updates the color tables from the video controller board and returns the values to 
the caller. Each color table contains 256 entries; each entry is a 10-bit value (0-1023). 

SEE ALSO 

DEVget_color_map(3S) 
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NAME 

DEVputimageheader - write a Pixel Machine image header to a file 

SYNOPSIS 

#include <stdio.h> 
#indude <host/devtools.h> 
#include <host/devimage.h> 
#in€lude <host/deverror.h> 

int DEVput_image_header(file, imageheader, optionalheader) 

FILE *file; 

DE Vimageheader * imageheader ; 

DEVbyte *optional_header; 

DESCRIPTION 

DEVputjmage_header writes the DEVimage_header and the optional user header (if one exists) to 
the specified file. 

file is a file descriptor obtained from a previous call to fopen(3). The file must have been successfully 
opened for writing and the file pointer should be pointing to the beginning of the file (i.e., no previous 
writes have been issued). Upon return from DEVput image_header, the file pointer will be set to 
where the pixel data should start (i.e., past the image and optional headers), 

DEYput_image_header will convert the DEVimageheader structure pointed to by imagejieader into 
a string of decimal ASCII characters and write it to the file pointed to by file. If the magic structure 
member is 0, it will be set to DEV_IMAGE_MAGIC before being written. If magic is non-zero, it will 
be written as is. 

If optional _header is non-zero, the characters pointed to it will be written io file immediately after the 
image header, image _header->optionalJieader_size bytes will be written. 

RETURNS 

DEVput_image_header returns upon success and -1 on failure. DEVput_image_header will set 
DEVerrno to indicate the reason for failure: 

DEV_ERR_BAD_MAGIC: The magic number is not DEV_IMAGE_MAGIC. 

DEV_ERR_WRITE_ERR: An error was returned by iht fwrite(3) system call while writing either 
the image header or the optional header. 

NOTES 

No value in the DEVimageheader should be greater than 100,000,000. 

SEE ALSO 

DEVimage_header(4) 
DEVget_image_header(3S) 
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NAME 

DEVput_pixel, DEVput_pixels - write pixels into the frame buffer 

SYNOPSIS 

#inclu(le <host/devtools.h> 

void DEVput_pixeI(system,buffer,x,y,r,g,b,o) 
DEVpixeisystem *system; 
int buffer, x, y; 
short r, g, b, o; 

void DEVputjpixels(system,buffer,x,y,r,g,b,o,npixI) 
DEVpixeisystem *system; 
int buffer, x, y; 
short *r, *g, *b, *o; 
int npixl; 

DESCRIPTION 

DEVput_pixel writes pixels into a frame buffer. Through this routine, a program can update the Pixel 
Machine frame buffer without having to deal with the details of how the frame memory is organized on 
different models of die system. 

system is a pointer to the system description information returned by DEVinit. buffer indicates which 
frame buffer is to be updated (must be the value or 1). jc is the x coordinate, y is the y coordinate, r, 
g, b, and o are the values to be stored in the red, green, blue, and overlay values in the frame buffer. 

DEVput j)ixels writes a sequence of pixels for a single scan line, npixl is the number of pixels to be 
written, r, g, b, and o point to a sequence of red, green, blue, and overlay values to be written. 

NOTES 

DEVput_scan_line provides a more efficient and flexible facility for dowloading image data. 

SEE ALSO 

DEVpixel_write(3S) 
DEVput_scanJine(3H) 
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DE Vput_scan_line ( 3H ) DEVtools DE Vput_scan_line ( 3H ) 



NAME 

DEVputscanJine - download an image or a portion of an image to a Pixel Machine 

SYNOPSIS 

include <host/devtools.h> 
#indude <host/devimage*h> 

int DEVputscan Jine(system, x, y, npixels, nlines, mode, pixelbuffer) 

DEVpixelsystem *system; 

unsigned int x, y; 

unsigned int npixels, nlines, mode; 

DEVpixel *pixel_buffer; 

DESCRIPTION 

DEVputscanJine transfers an image or a portion of an image from the host to a Pixel Machine. The 
data is transferred from the host memory area specified by pixeljbujfer according to the mode specified 
by mode, 

system is a pointer to the system description information returned by DEVinit. x is the starting x screen 
coordinate, y is the starting y screen coordinate. 

The buffer pointed to by pixeljbuffer must contain (npixels * nlines * pixel size) bytes, where the pixel 
size is determined by the mode argument as described below. In all cases, pixels will be accessed in. 
pixeljbuffer in the following order, (xy), (jc+l,y), ..., (x+npixelsAy), (x,y+l), ..., (x-^npixelsAy-^nlineS' 
1). 

The mode argument is used to specify two pieces of information: how the pixels are stored in the array 
pointed to by pixeljbuffer, and which portion of Pixel Machine memory the data should be copied to. 
These values are or'ed into the mode argument. Valid pixel format values for mode are: 

DEV_RGBA_PACKED_^PIXELS: pixels are stored in pixeljbuffer, 4 bytes to a pixel, in the 
following order: red, green, blue, alpha. 

DEVRGBPACKEDPIXELS: pixels are stored in pixeljbuffer, 3 bytes to a pixel, in the fol- 
lowing order red, green, blue. 

DEVMONORPIXELS: pixels are stored in pixeljbuffer, 1 byte to a pixel, with the red 
component of the pixel actually being stored. This option is not available when downloading to 
DEV_ZRAM_BUFFER. 

DEVMONOGPIXELS: pixels are stored in pixel Jyuffer, 1 byte to a pixel, with the green 
component of the pixel actually being stored. This option is not available when downloading to 
DEVZRAMBUFFER. 

DEVMONOBPIXELS: pixels are stored in pixeljbuffer, 1 byte to a pixel, with the blue 
component of the pixel actually being stored. This option is not available when downloading to 
DEVZRAMBUFFER. 

DEV_MONO_A_PIXELS: pixels are stored in pixel J)uffer, 1 byte to a pixel, with the alpha 
(overlay) component of the pixel actually being stored. This option is not available when 
downloading to DEVZRAMBUFFER. 

DEVMONOPIXELS: pixels are stored in pixel Jyuffer, 1 byte to a pixel. When downloading 
to VRAM, the 1 byte pixel is written to the red, green, and blue component of a pixel. 

DEV_M0N0_16_PIXELS: pixels are stored in pixeljbuffer, 2 bytes to a pixel. This option is 
only available when downloading to DEV_ZRAM_BUFFER. 

DEVDSPFLOATPIXELS: pixels are stored in pixeljbuffer, 4 bytes to a pixel. This option 
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is only available when downloading to DEVZRAMBUFFER. 

DEV_IEEE_FLOAT_PIXELS: pixels are stored in pixeljbuffer, 4 bytes to a pixel. During the 
download operation, the pixels are converted from IEEE format floating point to DSP floating 
point. This option is only available when downloading to DEV_ZRAM_BUFFER. 

The following values are or'ed into the mode argument to specify which portion of Pixel Machine 
memory to download to: 

DEV_FRONT_BUFFER: Download pixels to the front (currently displayed) portion of 
VRAM. 

DEV_BACK_BUFFER: Download pixels to the back (currently non-displayed) portion of 

VRAM. 

DEV_VRAMO__BUFFER: Download pixels to the VRAMO portion of VRAM. 
DEV^VRAMI BUFFER: Download pixels to the VRAMl portion of VRAM. 
DEV_ZRAM_BUFFER: Download pixels to ZRAM. 

The sizes of the above buffers vwry depending on the type of Pixel Machine being used as defined in the 
following table: 



c 



Model 


FRONT 


BACK 


VRAMO 


VRAMl 


ZRAM 


916 


1024x1024 


1024x1024 


- 


- 


1024x1024 


920 


1280x1024 


1280x1024 


- 


- 


1280x1024 


932 


1024x1024 


1024x1024 


1024x2048 


1024x2048 


1024x2048 


940 


1280x1024 


1280x1024 


1280x2048 


1280x2048 


1280x2048 


964 


2048x1024 


2048x1024 


2048x2048 


2048x2048 


2048x2048 


964X 


2048x1024 


2048x1024 


2048x2048 


2048x2048 


2048x2048 



c 



Note that subscreens are not used when downloading to ZRAM. 

RETURNS 

DEYput_scan_lme returns upon success and -1 on failure. DEVput^scanJine also sets DEVerrno 
and DEYerr^msg upon failure. 

NOTES 

DEVputscanJine sends a series of system commands to the pipe and pixel nodes to perform the 
download operation. Pixel node programs must be prepared to receive this command or 
DEVput_scan_line will fail. The pipe node programs must use PMgetop to read command opcodes. 
The download commands are implicitly copied through the pipe by PMgetop. The pixel node program 
should call PMenable during its initialization and should call PMgetcmd in its main processing loop. 
PMgetcmd will recognize the system command and call the appropriate routine to display the scan 
line(s). 

DEVput_scanJine is an optimized version of DEVput_pixels for operations like image upload and 
image processing. 

SEE ALSO 

DEYputj)ixels(3S) 

DEVinit(3H) 

PMenable(3N) 

PMgetcmd(3X) 

PMgetop(3P) 
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NAME 

DEVread_z - read a buffer of bytes from the Z memory of a pixel node 

SYNOPSIS 

#include <host/devtools.h> 

void DEVread_z(pixel_systein, node, x, y, buffer, n) 

DEVpixelsystem *pixel_system; 

int node; 

int X, y; 

DEVbyte *buffer; 

int n; 

DESCRIPTION 

DEVread_z reads a buffer of bytes from the Z memory of a pixel node. pixel__system is a pointer to the 
memory mapped control block of the processor whose memory is to be read, x and y are the coordi- 
nates in the Z memory where the read operation starts, biffer is a pointer to the area into which the 
data is to be read, n is the number of bytes to be read. 

The Z memory is organized as 256 rows of 256 32-bit words. '*x" is the row from which the data is to 
be read, **y" is the word offset of the data to be read. An even number of bytes is always read. 

Transfers must not attempt to wrap past the end of a row, or, in other words, the offset in bytes (y * 4) 
plus the number of bytes read {n) must not exceed the number of bytes per row (1024). 

NOTES 

This routine does not perform any byte order changes. 

SEE ALSO 

DEVpixeI_read(3S) 
DEVget_scan_Une(3H) 
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NAME 

DEVrelease_pipe_semaphore, DEVreleasepixelsemaphore - clear the software semaphore in the 
memory of one of the DSP processors 

SYNOPSIS 

#include <host/devtools.h> 

void DEVrelease_pipe_semaphore(pixel_system,node) 
DEVpixelsystem *pixel_system; 
int node; 

void DEVrelease_pixel_semaphore(pixel_system,node) 
DEVpixelsystem *pixel_system; 
int node; 

DESCRIPTION 

These routines are used to clear the software semaphore in the memory of one of the DSP processors. 
pixel_jystem is a pointer to the system descriptor, node is the number of the pipe or pixel node whose 
semaphore is to be reset. 

The semaphore can be set by a program running on one of the nodes by calling the PMsetsem routine. 

These routines are used by the message serving system, but may also be used by user applications that 
do not make use of the message serving routines. They should never be called by routines that serve 
message requests from the Pixel Machine, as this would effect the synchronization between the Pixel 
Machine and host system. 
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NAME 

DEVrun - begin execution of all pipe and pixel nodes 

SYNOPSIS 

void DEVrun(pixel_system) 

DE Vpixelsystem * pixelsy stem ; 

DESCRIPTION 

DEVrun is used to begin execution of the programs loaded into all pipe and pixel node processors. 
pixel_system is the system pointer returned by DEVinit. DEVinit must be called before calling DEV- 
run. If DEVpipe_boot and DEVpixelboot are used, they must be called before calling DEVrun. 

SEE ALSO 

DEVinit(3H) 

DEVpipe_boot(3H) 

DEVpixel_boot(3H) 
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NAME 

DEVserialdirection - updates the serial I/O link direction 

SYNOPSIS 

#include <host/devtools.h> 

int DEVserial_direction(system, direction) 
DEVpixelsystem *system; 
int direction; 

DESCRIPTION 

DEVserialdirection updates the serial I/O link direction. 

system is a pointer to the system description information returned by DEVopen. direction indicates the 
direction in which data is to be transferred, and must be one of: 

DEVNORTH 
DEV_EAST 
DEVSOUTH 
DEVWEST 

Based on the system type, the appropriate calls to DEVpixelmodeserial are executed to configure the 
system for the desired serial I/O direction. 

RETURNS 

Returns on success. 

SEE ALSO 

devprint(I) 

DEVpoll_nodes(3M) 

PMsiodir(3X) 
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NAME 

DEVshadowoff - turns off updating of color lookup tables from shadow tables 

SYNOPSIS 

#include <host/devtools.h> 

void DEVshadow_olT(pixel_system) 
DEVpixelsystem *pixel_system ; 

DESCRIPTION 

DEVshadow_off turns off updating of the color lookup tables from the shadow tables. To avoid flicker- 
ing caused by partially updated color tables, this function should be called before updating the lookup 
tables. 

SEE ALSO 

DEVshadow on(3S) 
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NAME 

DEVswapJong - convert from DSP32 long integers to host long integers 

SYNOPSIS 

#include <host /devtools.h> 

void 

DEVswap_long(buffer, nbyte) 
DEVbyte *buffer; 
int nbyte; 

DESCRIPTION 

DEVswapJong converts an array of long integers in DSP32 format to long integers in the host 
format(and vice- versa). The pointer to the array is passed in the argument buffer. The size of the array 
in bytes is passed in the argument nbyte. nbyte is not the number of elements in the array. 

The conversion is done in place. 

SEE ALSO 

DEVswap_short(3S) 
DEVdspJeee(3S) 
DEVieee_dsp(3S) 
DEVsswapl(3S) 
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NAME 

DEVswap jpipe - switch primary and alternate pipes of a dual pipe system 

SYNOPSIS 

#include <host/devtools.h> 

void DEVswap_pipe() 

DESCRIPTION 

On a dual pipe system, with the pipes operating in parallel mode, one pipe is the primary pipe and the 
other is the adtemate pipe. DEVswappipe reverses the functions of the two pipes. This is used to bal- 
ance the load between the two pipes. 

DEVsvi^ap jpipe sends a system command to the primary pipe to perform the broadcast bus arbitration. 
The command is passed through each of the pipe nodes until it reaches the last pipe node. When the 
last pipe node processes the swap- pipe command, it releases the broadcast bus to the alternate pipe. It 
then requests the bus and waits for bus access to be granted. 

NOTES 

Programs in pipe nodes 8 and 17 must have called PMenable(PM_ENABLE_SWAP_PIPE) in order to 
correctly respond to the system command that DEVswappipeO sends. 

Pipe node programs must use PMgetop to read command opcodes. The swap-pipe commands are 
implicitly copied through the pipe by PMgetop. 

Pipe node programs can control the broadcast bus independently using the PMswap jpipe function. 

SEE ALSO 

PMenable(3N) 
PMgetop(3P) 
PMbus_wait(3P) 
PMswap_pipe(3P) 
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NAME 

DEVswap_short - convert from DSP32 short integers to host short integers 

SYNOPSIS 

#include <host/devtools.h> 

void 

DEVswap_short(buffer, nbyte) 
DEVbyte *buffer; 
int nbyte; 

DESCRIPTION 

DEVswap_short converts an array of short integers in DSP32 format to short integers in the host format 
(and vice- versa). The pointer to the array is passed in the argument buffer. The size of the array in 
bytes is passed in the argument nbyte. nbyte is not the number of elements in the array. 

The conversion is done in place. 

SEE ALSO 

DEVswapJongOS) 

DEVdsp_ieee(3S) 

DEVieee_dsp(3S) 
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NAME 

DEVuser_msg_enable - define a message code and specify functions to be called 

SYNOPSIS 

#include <host/devtools.h> 
#mclude <host/msgserve.h> 

int DEVuser_msg_enable(code, pipefunction, pixelfunction) 
int code; 

int (*pipefunctioii)(), 
(*pixelfunction)0; 

DESCRIPTION 

DEVuser jmsgenable allows a program to define a message code that is to be recognized by the pol- 
ling routine, and to specify the functions that are to be called to service the message. 

code is the user message code. It must be greater than zero, but must be less than the value 
DEV_HIGHEST_USER_MESSAGE (defined in hosVmsgserve.h). 

When a user message with the value code is received from a DSP, the polling routine will call 
pipefunction if the message is from a pipe node, or pkelfunction if the message is from a pixel node. 

pipefunction must be defined as: 

int pipefunction (opcode^ pixel__system^ node) 

int opcode; 

DEVpixel__system *pixel_system/ 

int node; 

pixelfunction must be defined as: 

int pixelfunction (opcode^ pixel_system, node) 

int opcode; 

DEVpixel_system^ *pixel_system; 

int node ; 

opcode is the value of code\ this allows one function to service several codes. pixel_system is the sys- 
tem descriptor, node is the node number of the processor that sent the message. 

SEE ALSO 

DEVpoII_nodes(3H) 
PMusermsg(3N) 
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NAME 

DEVwait_exit - wait for pixel nodes to signal completion, then call DEVexit 

SYNOPSIS 

void DEVwaitexitO 

DESCRIPTION 

DEVwait_exit sends a system command to all pixel nodes informing them that the host wishes to exit. 
The pixel node programs must have called PMenable with the PMENABLEWAITEXIT argument at 
initialization in order to process the system command correctly. 

Upon receipt of the system command, the pixel nodes perform a PMpsync operation to ensure all nodes 
have finished, then sends a message to the host. When the host sees this message, it automatically calls 
DEVexit before returning to the user. 

SEE ALSO 

DEVclose(3S) 
DEVinit(3H) 
DEVexit(3H) 
PM€nable(3N) 
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NAME 

DEVwrite, DEVcwrite, DEVwriten, DEVcwriten, DEVwritealt, DEVcread, DEVreadn, 
DEVreadnalt, - macros to write to the Pixel Machines pipelines and read commands back from the 
feedback HFO 

SYNOPSIS 

#include <host/devtools.h> 
#iiiclude <host/devcommand.h> 

DEVulong DEVcommand(opcode,length) 
short opcode; 
short length; 

short DEVcommand_opcode(command) 
long command; 

short DEVcommand_length(command) 
long command; 

void DEVcwriteO(command) 
long command; 

void DEVcwriteO_alt(command) 
long command; 

void DEVcwritel(command,type^) 

long command; 

/* type is the type name of the remaining arguments */ 

type x; 

void DEVcwritel_alt(command,type^) 

long command; 

/* type is the type name of the remaining arguments */ 

type x; 

void DEVwritel(type,x) 

/* type is the type name of the remaining arguments */ 

type x; 

void DEVwritel_alt(type^) 

/* type is the type name of the remaining arguments */ 

type x; 

void DEVcv*Tite2(command,type^,y) 

long command; 

/* type is the type name of the remaining arguments */ 

type X, y; 

void DEVcwrite2_aIt(command,type,x,y) 

long command; 

/* type is the type name of the remaining arguments */ 

type X, y; 
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void DEVwrite2(type,x,y) 

/* type is the type name of the remaining arguments */ 

type X, y; 

void DEVvinrite2_alt(type^,y) 

/* type is the type name of the remaining arguments */ 

type X, y; 

void DEVcwrite3(command,type^,y,z) 

long command; 

/* type is the type name of the remaining arguments */ 

type X, y, z; 

void DEVcwrite3_alt(command,type,x,y,z) 

long command; 

/* type is the type name of the remaining arguments */ 

type X, y, z; 

void DEVwrite3(type,X5y,z) 

/* type is the type name of the remaining arguments */ 

type X, y, z; 

void DEVwrite3_alt(type^,y,z) 

/* type is the type name of the remaining arguments */ 

type X, y, z; 

void DEVcwrite4(command,type,x,y,z,w) 

long command; 

/* type is the type name of the remaining arguments ^^1 

type X, y, z, w; 

void DEVcwrite4_alt(command,type,x,y,z,w) 

long command; 

/* type is the type name of the remaining arguments */ 

type X, y, z, w; 

void DEVwrite4(typejX,y,z,w) 

/* type is the type name of the remaining arguments */ 

type X, y, z, w; 

void DEVwrite4_alt(type^,y,z,w) 

/* type is the type name of the remaining arguments */ 

type X, y, z, w; 

void DEVcwrite5(command,type,a,b,c,d>e) 

long command; 

/* type is the type name of the remaining arguments */ 

type a, b, c, d, e; 

void DEVcwrite5_alt(command,type,a,b,c,d,e) 

long command; 

/* type is the type name of the remaining arguments */ 

type a, b, c, d, e; 



( 



c 
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void DEVwrite5(type,a,b,c,d9e) 

/* type is the type name of the remaining arguments */ 

type a, b, c, d, e; 

void DEVwrite5_alt(type,a,b,c,d>e) 

/* type is the type name of the remaining arguments */ 

type a, b, c, d, e; 

void DEVcwrite6(command,type^,b,c,d>e,f) 

long command; 

/* type is the type name of the remaining arguments */ 

type a, b, c, d, e, f; 

void DEVcwrite6_alt(command,type^,b,c,d>e,f) 
long command; 

/* type is the type name of the remaining arguments */ 
type a, b, c, d, e, f; 

void DEVwrite6(type,a,b,c,d,e,f) 

/* type is the type name of the remaining arguments */ 

type a, b, c, d, e, f; 

void DEVwrite6_alt(type,a,b,c,d>e>0 

1^ type is the type name of the remaining arguments */ 

type a, b, c, d, e, f; 

void DEVcwrite7(command,type^,b,c,d,e,f,g) 

long command; 

/* type is the type name of the remaining arguments */ 

type a, b, c, d, e, f, g; 

void DEVcwrite7_alt(command,type^,b,c,d,e,f,g) 
long command; 

/* type is the type name of the remaining arguments */ 
type a, b, c, d, e, f, g; 

void DEVcwrite8(command,type,a,b,c,d>e,f,g,h) 
long command; 

/* type is the type name of the remaining arguments */ 
type a, b, c, d, e, f, g, h; 

void DEVcwrite8_alt(command,type^,b,c,d,e,f,g,h) 
long command; 

/* type is the type name of the remaining arguments */ 
type a, b, c, d, e, f, g, h; 

void DEVcwrite9(command,type,a,b,c,d,e,f,g,h,i) 
long command; 

/* type is the type name of the remaining arguments */ 
type a, b, c, d, e, f, g, h, i; 

void DEVcwrite9_alt(command,type,a,b,c,d>c,f,g,h,i) 
long command; 
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/* type is the type name of the remaining arguments */ 
type a, b, c, d, e, f, g, h, i; 

void DEVwrite9(type^,b,c,d,e,f,g,h,i) 

long command; 

h type is the type name of the remaining arguments */ 

type a, b, c, d, e, f, g, h, i; 

void DEVwrite9_alt(type,a,b,c,d>e,f,g,h,i) 

long command; 

I* type is the type name of the remaining arguments */ 

type a, b, c, d, e, f, g, h, i; 

void DEVcviTiten(command,type,block,length) 

long command; 

/* type is the type name of block */ 

type block[]; 

int length; 

void DEVcwriten_alt(command,type,block,length) 

long command; 

/* type is the type name of block */ 

type block[]; 

int length; 



void DEVwriten(type,blockjlength) 
/* type is the type name of block */ 
type block[]; 
int length; 

void DEVwrite_alt(type,block,length) 
/* type is the type name of block */ 
type block[]; 
int length; 

void DEVcreadO(command) 
long command; 

void DEVcreadO_alt(command) 
long command; 

void DEVreadn(type,block,length) 
/* type is the type name of block */ 
type block[]; 
int length; 

void DEVreadn_alt(type,block,length) 
/* type is the type name of block */ 
type block[]; 
int length; 



c 



c 
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DESCRIPTION 

These macros are used to write commands to the Pixel Machine pipelines and to read commands back 
from the feedback FIFO. 

Each command consists of a command code, an operand count, and a list of 32-bit operands. The 
operands can be integers, host floating point numbers, or Pixel Machine floating point numbers. The 
interpretation of the contents of the operands is the responsibility of the user written code on the Pixel 
Machine that interprets the commands. 

Macros that end with the string alt write to the alternate pipe of a multi-pipe system, the routines 
without alt write to the primary pipe, alt macros must not be used on single pipe systems or on 
multi-pipe systems whose pipes are configured in parallel. 

DEVcommand is used to encode an opcode and parameter count into a 32-bit command code. The 
command argument of the DEVcwrite macros is usually a call to DEVcommand. 

DEVcommand^opcode and DEVcommandJength are used with the DEVreadn macros to extract the 
opcode and length from the encoded value. 

The DEVcwriteO through DEVcwrite9 macros are used to write commands and a number of operands 
that match the last character of the macro name. DEVwriteO through DEVwrite9 macros write only 
operands, they do not output a command code. 

The read and write macros contain a type argument. This indicates the type of the arguments being read 
or written. The storage class of the type argument must be such that sizeof(type) == 4 bytes and type is 
word aligned. All of the argument types in a given macro invocation must be the same. To create a 
command with four arguments, the first two of which are floats and the last two of which are ints, the 
following sequence of commands must be used: 

DEVcwrite2(DEVcommancl(opcode, 4), float, x, y); 
DEVwrite2(int, i, j); 

The DEV^writen and DEV_readn macros are used to write and read a block of operands, block is an 
array of values to be used as operands, length is the number of elements of block to be used, length 
must be less then or equal to 64. 



NOTES 



In a pipeless Pixel Machine, the DEVwrite macros write direcdy to the broadcast bus FIFOs. The 
DEVread and alt macros should not be used in a pipeless Pixel Machine. 
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NAME 

DEVwritez - writes a buffer of bytes into the Z memory of a pixel node 

SYNOPSIS 

#include <host/devtools.h> 

void DEVwrite_z(pixel_system,node, x, y, buffer, n) 

DEVpixelsystem *pixel_system; 

int node; 

int X, y; 

DEVbyte *buffer; 

int n; 

DESCRIPTION 

DEVwrite_z writes a buffer of bytes into the Z memory of a pixel node. pixel_system is a pointer to 
the system description information returned by DEVopenQ. x and y are the coordinates in the Z 
memory where the write operation starts, buffer is a pointer to the data to be written, n is the number 
of bytes to be written. 

The Z memory is organized as 256 rows of 256 32-bit words. **x" is the row to which the data is to be 
written, '*y" is the word offset of the data to be written. An even number of bytes is always written. 

Transfers must not attempt to wrap past the end of a row, or, in other words, the offset in bytes (y * 4) 
plus the number of bytes written (n) must not exceed the number of bytes per row (1024). 

NOTES 

This routine does not perform any byte order changes. 

SEE ALSO 

DEVput scan line(3H) 
DEVopen(3S) 
DEVpixel write(3S) 
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NAME 

PMapply - apply a function to all subscreens 

SYNOPSIS 

#include <pxm.h> 

void PMapply(function [,arg] .•.) 
void (*function)(PMsubscrn *scrn ..,); 

DESCRIPTION 

PMapply provides a convenient method of calling a rendering function once for each subscreen, 
independent of the Pixel Machine model the code is being run on. function must take a pointer to a 
subscreen structure as its first argument, which is inserted by PMapply; the other args given to PMap- 
ply are passed on unchanged in each call to function made by PMapply. 

EXAMPLES 

To set a pixel node's image memory to a specified color using the DEVtools routine PMclear: 

PMpixeltype color; 

PMapply (PMclear^ 0^ 0^ PMimax^ PMjmax^ &color) ; 

Without PMapply the above call would have to be written: 

PMclear (PMscrns [0] , 0, 0, PMimax, PMjmax^ &color) ; 

if (PMmx) 

{ 

PMclear (PMscrns [11^0, 0^ PMimax, PMjmax^ &color) ; 

if (PMmy) 

{ 

PMclear (PMscrns [2] ^ 0^ 0^ PMimax^ PMjmax^ &color) ; 
PMclear (PMscrns [3] ^0,0, PMimax, PMjmax, &color) ; 

} 
} 

Of course, if the user is not concerned with portability across different models of the Pixel Machine, nei- 
ther PMapply nor the if statements are needed. In this case, specify 1, 2 or 4 calls to the required func- 
tion (in this example PMclear) with the corresponding subscreen argument, depending on the number of 
subscreens in the model. 

NOTES 

PMapply is only useful in calling routines that do not modify their arguments and whose return value is^ 
not needed. 
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NAME 

PMclear - fill a rectangular region of the screen 

SYNOPSIS 

#include <pxm.h> 

void PMclear(scrn, imin, jmin, imax, jmax, color) 
PMsubscrn *scrn; 
short imin, jmin; 
short imax, jmax; 
PMpixeltype *color; 

DESCRIPTION 

PMclear fills a retangular section of a pixel node's subscreen memory with color, scrn is a pointer to 
an initialized PMsubSCrn structure. 

imin, jmin, imax and jmax are subscreen coordinates with the legal ranges: 

/ [0, PMimax] 
j [0,PMjmax] 

PMimax and PMjmax are automatically initialized to the appropriate value for the current model (see 
the DEVtools User's Guide for more information on subscreen ranges). 

Values beyond these ranges will generate unpredictable results. 

color is a pointer to a PMpixeltype structure containing the red, green, blue and overlay components to 
PMclear the region to. Each pixel within the region bounded by imin, imax, jmin, and jmax will be set 
to these values. 

NOTES 

Refer to PMzbrk(3X) for page register use. 
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NAME 

PMcolor_float - macro that converts internal color value to floating point number 

SYNOPSIS 

#include <pxm.h> 

float PMcolor_float(color) 
int color; 

DESCRIPTION 

PMcolor_float is a macro that converts an internal color value to a floating point number in the range 
0.0 - 1.0. 

SEE ALSO 

PMint_color(3N) 
PMcolorintON) 
PMfloat_color(3N) 
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NAME 

PMcolorint - macro that converts internal color value to an integer 

SYNOPSIS 

#inclu(le <pxm.h> 

int PMcolor_int(color) 
int color; 

DESCRIPTION 

PMcolor_int is a macro that converts an internal color value to an integer in the range - 255. 

SEE ALSO 

PMcolor_float(3N) 
PMfloat_color(3N) 
PMint color(3N) 
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NAME 

PMcopy_f - fast but dangerous 32 bit DA^AM copy 

SYNOPSIS 

void PMcopy_f(to, from, count) 
register float *to, *from; 
register int count; 

DESCRIPTION 

PMcopy_f copies count words (4 bytes each) using a sequence of the longword-copy instruction: 

aO = frJ++ = r4++) * aO; 

to reduce loop overhead. 

to and from are any kind of pointer as long as they are 4 byte aligned. They can be pointers that use 
page registers. They will work properly as long as the appropriate page registers were correctly initial- 
ized. 

For copying VRAM, it is necessary to call PMcopy_f twice, once with RG pointers and once with BO 
pointers. 

This is the most efficient copy available. PMcopyf calls mover which can copy up to 64 words with no 
overhead, mover resides in BANK 1 to eliminate conflict wait states in most cases. 

For VRAM or DRAM to VRAM or DRAM copy, each 32-bit copy takes 550ns including clock stretch- 
ing. For VRAM or DRAM to SRAM (and vice- versa) each copy is 375ns. For SRAM it takes 200ns 
plus any possible conflict wait states. If both pointers point to BANK (.text section or automatic data), 
there are no wait states. If one pointer is in BANK 1, there is one 50ns conflict wait state, two if both 
pointers point to BANK 1. All global and static data generated by the C compiler reside in BANK 1 by 
default. Lx)op overhead is only encountered every 64 words. 

NOTES 

This copy is so blindingly fast that it may interfere with the video shift register load temporarily mess- 
ing up the display. This problem only occurs in VRAM; it is perfectly safe in SRAM. 

RETURNS 

Results are undefined if the to and from pointers overlap. 

If count < 1 it will be treated as a 1. 

SEE ALSO 

PMcopy_s(3X) 
PMcopy_v(3X) 
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NAME 

PMcopy_s - safe 32-bit DRAM or VRAM copy 

SYNOPSIS 

void PMcopy_s(to, from, count) 
register float *to, *from; 
register int count; 

DESCRIPTION 

PMcopy_s copies count words (4 bytes each) using a 2 instruction loop. 

to and from are any kind of pointer, but they must be 4 byte aligned. They can be pointers that use 
page registers. They will work properly as long as the appropriate page registers were correcdy initial- 
ized. 

For copying VRAM, it is necessary to call PMcopys twice, once with RG pointers and once with BO 
pointers. 

This copy is a little slower than PMcopyf, but is guaranteed not to cause any video flashing problems. 
It also resides in BANK 1 to eliminate conflict wait states in most cases. 

For VRAM or DRAM to VRAM or DRAM copy, each 32-bit copy takes 550ns including clock stretch- 
ing. For VRAM or DRAM to SRAM (and vice-versa) each copy is 375ns. For SRAM it takes 200ns 
plus any possible conflict wait states. If both pointers point to video bank (.text section or automatic 
data), there are no wait states. If one pointer is in video bank 1, there is one 50ns conflict wait state, 
two if both pointers point to video bank 1. All global and static data generated by the C compiler reside 
in video bank 1 by default. Add to these times 200ns for loop overhead per word. 

NOTES 

Results are undefined if the to and from pointers overlap or are not 4 byte aligned. 

If count < 1 PMcopys will return immediately. 

SEE ALSO 

PMcopy f(3X) 

PMcopy v(3X) 
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NAME 

PMcopy_v - 32- bit copy with variable increments 

SYNOPSIS 

void PMcopy_v(to, from, toinc, frominc, count) 
register float *to, *from; 
register int toinc, frominc; 
register int count; 

DESCRIPTION 

PMcopyv is similar to PMcopys but it allows the user to specify the increments for both the to and 
from pointers. The 32-bit copy and both increments are all accomplished in one DSP32 instruction, 
plus one more instruction for loop control. 

to and from can be any kind of pointer, but must be 4 byte aligned, tojnc and from Jnc are the incre- 
ments to be added to the pointers after each 32-bit copy. 

count is the number of 4 byte words to copy. 

NOTES 

Results are undefined if the to and from pointers overlap, or are not 4 byte aligned. 

RETURNS 

If count < 1 PMcopyv returns immediately. 

SEE ALSO 

PMcopy_s(3X) 
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NAME 

PMcopycmd - copy opcode, parameter count, and data from input to output FIFO of a pipe node 

SYNOPSIS 

#include <pxm.h> 

void PMcopycmdO 

DESCRIPTION 

PMcopycmd copies the opcode, count, and parameters of a pipe command to the output FIFO. The 
parameters are copied directly from the input HFO, but the opcode and count are copied from the 
PMcommand structure (which is initialized by a previous call to PMgetop). 

NOTES 

PMcopycmd can only be called from a pipe node program. 

SEE ALSO 

PMcommand(4N) 

PMgetop(3P) 

PMg€tcmd(3X) 

PMg€tdata(3P) 

PMputop(3P) 

PMputdata(3P) 
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NAME 

PMcopyftob - copy front to back 

SYNOPSIS 

Mnclude <pxm.h> 

void PMcopyftob(scrn, i, j, npix, nline) 

PMsubscrn *scrn; 

int i,j; 

int npix, nline; 

DESCRIPTION 

PMcopyftob copies a block of video memory from the front buffer to the back buffer. 

scrn is a pointer to an initialized PMsubscrn structure, i and j are the starting location of the block to 
be copied, npix is the number of pixels and nline is the number of scan lines to be copied. 

/ andy are in the range of [0-PMimax] and [0-PMjmax], respectively, npix and nlines are in the range 
of [1-PMimax+l] and [1-PMjmax+l], respectively. 

This function also works in single buffer mode. 

NOTES 

Values outside these ranges will generate unpredictable results. 

To copy from the back to front buffer call PMswapback before and after the call to PMcopyftob. 

PMcopyftob saves and restores page registers. 

SEE ALSO 

PMswapback(3X) 
PMcopyvtov(3X) 
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NAME 

PMcopyvtov - copy blocks of VRAM 

SYNOPSIS 

#include <pxm.h> 

void PMcopyvtov(bank_from, bankto, i, j, ni, nj, di, dj) 
int bankfrom, bankto; 

int i, j; 

int ni, nj; 

int di,dj; 

DESCRIPTION 

PMcopyvtov copies a block of video memory from the specified video bank bankjrom to bank Jo, 

The banks can be PM^VRAMO^BUFFER or PM_VRAM1_BUFFER. You can copy from either bank 
to itself, or to the other bank. 

i and j are the starting location of the block to be moved. 

ni and nj are the number of pixels in the i and j directions, respectively, to be copied. 

di and dj are the destination coordinates of the block. 

i, y, di and dj are all in the range [0-255]; ni and nj are in the range [1-256]. 

NOTES 

A value of less than 1 is treated as 1. Values outside these ranges will generate unpredictable results. 

SEE ALSO 

PMcopy_s(3N) 
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NAME 

PMcopyvtoz - copy video RAM to DRAM 

SYNOPSIS 

#mclude <pxm.h> 

void PMcopyvtoz(scrn, starti, startj, leni, lenj, dest i, destj, mode) 

PMsubscrn *scrn; 

int starti; 

int startj; 

int leni; 

int len_j; 

int dest i; 

int dest_j; 

int mode; 

DESCRIPTION 

PMcopyvtoz copies a rectangular section of the VRAM buffer, lenJ pixels by lenJ pixels, from the 
processor space coordinates, startj and startj, to the Z (DRAM) buffer. destJ and dest J are the des- 
tination coordinates in DRAM, and correspond to startj and startj, respectively. The section that is 
copied depends on the value of mode. If the value is the defined constant PM_FRONT_BUFFER, the 
image wiU be copied from the front, or visible, buffer. If the value is the defined constant 
PM_BACK_BUFFER, the image will be copied from the back, or invisible, buffer. Images in VRAM 
1 can be copied by or'ing in the value PM_VRAM1_BUFFER. 

The pixel data is organized in ZRAM so that the color data is placed into four adjacent bytes, in the 
order red, green, blue, overlay. Pixels with the same value of y are stored in the same row of memory; 
those with the same value of x and same color, are stored in the same column. Each pixel that is owned 
by a processor is adjacent to the next pixel owned by that processor, regardless of subscreen. For exam- 
ple, ZRAM for a 964 will contain data for every eighth pixel in both x and y, while ZRAM for a 916 
will contain the data for every fourth pixel in both x and y. Each pixel is copied to a different, well 
defined, location. Pixels do not overwrite each other. 

NOTES 

It does not make sense to use PM_VRAM1_BUFFER on models 916 or 920 because screen pixels are 
already stored in both sections of VRAM. 

This function can be called using PMapplyO, which will call the function for all subscreens for each of 
the processor coordinates chosen. However, if the data to be copied does not align so that the upper left 
hand pixel falls on node and subscreen 0, and the lower right hand pixel falls on the highest processor 
and highest subscreen, the function will need to be called more selectively. In that case the processor 
coordinates for each subscreen and the processors involved will need to be calculated from screen space, 
and this function called within each pixel node for each subscreen structure, with the appropriate argu- 
ments. 

SEE ALSO 

PMcopyztov(3X) 
PMcopyztoz(3X) 
PMqcopyztoz(3X) 
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NAME 

PMcopyztov - copy DRAM to video RAM 

SYNOPSIS 

#include <pxm.h> 

void PMcopyztov(scrn, starti, startj, lenj, lenj, destj, destj, mode) 

FMsubscrn *scrn; 

int starti; 

int startj; 

int leni; 

int lenJ; 

int desti; 

int destj; 

int mode; 

DESCRIPTION 

PMcopyztov copies a rectangular section of DRAM, lenJ pixels wide by lenJ pixels high, starting at 
coordinates startj and startj, to the VRAM buffer, destj and destj are the destination coordinates in 
VRAM, and correspond to startj and startj, respectively. The section of VRAM which is copied to 
depends on the value of mode. If the value is the defined constant PM_FRONT_BUFFER, the image 
will be copied to the front, or visible, buffer. If the value is the defined constant PM_BACK_BUFFER, 
the image will be copied to the back, or invisible, buffer. These values may be or'ed with 
PM_VRAM1_BUFFER to copy to VRAMl. 

This function is the inverse of PMcopyvtoz(), and assumes that the data in DRAM has the structure that 
PMcopyvtoz would impose. 

NOTES 

It does not make sense to use PM_VRAM1_BUFFER on models 916 or 920 because screen pixels are 
already stored in both sections of VRAM. 

SEE ALSO 

PMcopyvtoz(3X) 
PMcopyztoz(3X) 
PMqcopyztoz(3X) 
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NAME 

PMcopyztoz - copy from one section of DRAM to another 

SYNOPSIS 

#include <pxin.h> 

void PMcopyztoz(start J, startj, lenj, lenj, dest i, destj) 

int starti; 

int startj; 

int leni; 

int lenj; 

int dest i; 

int dest J; 

DESCRIPTION 

PMcopyztoz copies a rectangular section of DRAM, with dimensions lenj long words (4 byte units) by 
lenj long words, starting at coordinates startj from startj to another section of DRAM buffer, dest J 
and dest J are the destination coordinates, and correspond to startj and startj, respectively. 

The J arguments are in units of 4 bytes, e.g., 1 byte for each of red, green, blue and overlay, or the 
space for one float. Thus, if startj is set to 1, and lenj is set to 2, 8 bytes will be copied on each row, 
starting at an offset of 4 bytes from the beginning of the row. In the J direction, one row is copied to 
one row. 

NOTES 

This function provides a copy from one address to another, arbitrary, address. If there is no chance of 
overlapping copies, the function PMqcopyztoz() should be used, because it is faster and uses less code 
space. 

SEE ALSO 

PMqcopyztoz(3X) 

PMcopyvtoz(3X) 

PMcopyztov(3X) 



Pixel Machines Last change: Version 1.1 



PxMcos(3M) DEVtools PMcos(3M) 



NAME 

PMcos - trigonometric function to compute the cosine of an angle 

S\AOPSIS 

#include <libmath.h> 

float PMcos(theta) 
float theta; 

DESCRIPTION 

PMcos returns the cosine of theta. 

theta must be in radians and be between -Pi/2 and +Pi/2. 
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NAME 

PMdblbuff - enable double buffering mode 

SYNOPSIS 

#include <pxm.h> 

void PMdblbuffO 

DESCRIPTION 

PMdblbuff enables double buffering. Double buffering implies a distinction between a visible buffer 
that is displayed by the video controller and a pixel buffer in which pixels are modified. PMswapbuff 
exchanges these two buffers. 

PMsnglbuff disables double buffering. 

SEE ALSO 

PMswapbuff(3X) 
PMsngIbufT(3X) 
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NAME 

PMdelay - do nothing for a specified time 

SYNOPSIS 

#include <pxm.h> 

void PMdelay(time) 
int time; 

DESCRIPTION 

PMdelay executes a delay loop for {time / 250) seconds. 
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NAME 

PMenable - enable processing of selected system commands 

SYNOPSIS 

#include <pxm.h> 
#include <syscmd.h> 

void PMenable(functioii) 

DESCRIPTION 

PMenable enables reception of certain system commands that are sent by host programs. After calling 
PMenable, any system commands that are generated by the host will be correctly processed when the 
pixel node receives them using PMgetcmd. 

PMenable should be called as part of the program's initialization and must be called with one of the 
following #defines: 

PM_ENABLE_GET_SCAN_LINE: Enables processing of all system commands sent by the 
DEVget_scan_line host routine. This option allows upload of pixels from both VRAM and ZRAM. 
This option only applies to pixel nodes. 

PM_ENABLE_GET_VRAM: Enables processing of system commands sent by the 
DEVget_scan_line host routine to upload pixels from VRAM only. This option saves space if 
ZRAM pixel upload is not needed. This option only applies to pixel nodes. 

PMENABLEGETZRAM: Enables processing of system commands sent by the 
DEVget_scan_line host routine to upload pixels from ZRAM only. This option saves space if 
VRAM pixel upload is not needed. This option only applies to pixel nodes. 

PM_ENABLE_PUT_SCAN_LINE: Enables processing of all system commands sent by the 
DEVput_scan_line host routine. This option allows download of pixels to both VRAM and 
ZRAM. This option only applies to pixel nodes. 

PMENABLEPUTVRAM: Enables processing of system commands sent by the 
DEVputscanline host routine to download pixels to any portion of VRAM. This option saves 
space if ZRAM pixel upload is not needed. This option only applies to pixel nodes. 

PM_ENABLE_PUT_ZRAM: Enables processing of system commands sent by the 
DEVput_scan_line host routine to download pixels to any portion of ZRAM. This option saves 
space if VRAM pixel upload is not needed. This option only applies to pixel nodes. 

PM_ENABLE_SWAP_PIPE: Enables processing of system commands sent by the DEVswap_pipe 
host routine. This option only applies to pipe nodes, and should only be used by the last node of 
each parallel pipe (nodes 8 and 17). 

PM_ENABLE_WAIT_EXIT: This option allows processing of system commands sent by the 
DEVwait_exit host function. This option applies only to pixel nodes. 

If PMenable is not called before the host sends the system command, the system command will not be 
processed correctly. 

NOTES 

PMenable is implemented as a macro. 

It is important to enable only those functions that will actually be used, because each one takes up addi- 
tional code space. 
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SEE ALSO 

DEVgerscaiiJiiie(3H) 

DEVput_scaiiJine(3H) 

DEVswapj)ipe(3S) 

DEVwait_exit(3H) 

PMgetcmd(3X) 



( 
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NAME 

PMfb_on - direct output commands to the feedback FIFO 
PMfb_off - direct output commands to the regular output FIFO 

S\^OPSIS 

#mclude <pxm,h> 

void PMfbonO 
void PbfboffO 

DESCRIPTION 

PMfb_on directs the output of subsequent PMputop, PMputdata, and PMcpycmd calls to the feedback 
FIFO instead of the output FIFO. 

PMfboff redirects the output to the output FIFO instead of the feedback FIFO. 

NOTES 

These functions must only be called from the last pipe node of each pipe board (nodes 8 and 17), 
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NAME 

PMfdiv - perform floating point division 

SYNOPSIS 

#mclude <libmath.h> 
float PMfdiv(a, b) 
float a, b; 

DESCRIPTION 

PMfdiv computes the floating point value a * (l.O / b). If b is equal to zero, PMfdiv returns a large 
value of the same sign as a. 

NOTES 

PMfdiv is intended to be called by assembly language routines. 
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NAME 

PMfreezaddr - decrement references to a page register 

SYNOPSIS 

#include <pxm.h> 

void PMfreezaddr(ptr) 
char *ptr; 

DESCRIPTION 

PMfreezaddr is called to decrement the number of references to a page register, ptr is the pointer 
returned by a previous call to PMgetzaddr. The pointer may have been incremented and still work with 
PMfreezaddr as long as it did not get incremented past the end of the block. 

Neither the contents of the page register nor the contents of the memory are changed in any way. The 
purpose of PMfreezaddr is to make the page register available for use when it is no longer needed to 
access this particular address, so that it may be used by a call to PMgetzaddr with a different PMzdesc 
descriptor. 

NOTES 

If PMfreezaddrO is called with the PMzdesc returned by PMgetzaddrQ, and PMgetzaddrQ is called 
again with the same PMzdesc, the value of the returned pointer may change, but the contents of the 
memory pointed to will not be changed. 

SEE ALSO 

PMgetzaddr(3X) 

PMgetzdesc(3X) 

PMzbrk(3X) 

PMblock_reg(3X) 

PMavaiI_reg(3X) 

PMset_lowreg(3X) 

PMset_hireg(3X) 
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NAME 

PMfxtoi - map a linear function of x from screen space to processor space i 

SYNOPSIS 

#include <pxm.h> 

PMfxtoi(scrn, a, b) 
PMsubscrn *scrii; 
float a, b; 

DESCRIPTION 

PMfxtoi converts an expression of the form f{x)=Axy x-¥Bxy to an expression of the form 
f(i)=Aij i-¥Bij, The macro actually modifies the values of A and B . 

In the above expressions, the subscripts xy and ij are used to denote a constant in (xj) space and a 
constant in {ij) space, respectively. 

NOTES 

PMfxtoi is implemented as a macro. 

SEE ALSO 

DEVtools User's Guide 

PMfxytoij(3X) 

PMfytojOX) 
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NAME 

PMfxytoij - map a linear function of x and y from screen space to processor space i and j 

SYNOPSIS 

#include <pxm.h> 

PMfxytoij(scrn, a, b, c) 
FMsubscrn *scrn; 
float a, b, c; 

DESCRIPTION 

PMfxyoij converts an expression of the form f(x,y)=Axy x+Bxy y-^Cxy to an expression of the form 
f{iJ)=Aij i+Bij j-^Cij. The macro actually modifies the values of A, 5 and C. 

In the above expressions, the subscripts xy and ij are used to denote a constant in (x,y) space and a 
constant in (ij) space, respectively. 

NOTES 

PMfxytoij is implemented as a macro. 

SEE ALSO 

DEVtools User's Guide 

PMfxtoi(3X) 

PMfytojOX) 
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NAME 

PMfytoj - map a linear function of y from screen space to processor space j 

SYNOPSIS 

#include <pxm.h> 

PMfytojCscm, a, b) 
PMsubscrn *scrn; 
float a, b; 

DESCRIPTION 

PMfytoj converts an expression of the form /(y)=Ary y-^Bxy to an expression of the form 
f(J)=Aij j+Bij. The macro actually modifies the values of A and B , 

In the above expressions, the subscripts xy and ij are used to denote a constant in (jc,y) space and a 
constant in (ij) space, respectively. 

NOTES 

PMfytoj is implemented as a macro. 

SEE ALSO 

DEVtools User's Guide 

PMfxtoi(3X) 

PMfxytoijOX) 
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NAME 

PMgetcmd - load command from a pixel node FIFO 

SYNOPSIS 

#include <pxm,h> 

short PMgetcmdO 

DESCRIPTION 

PMgetcmd reads an opcode, parameter count, and parameters from the input FIFO and stores them in 
the global PMcommand structure. The parameters are placed in the array pointed to by 
PMcommand.dataptr. The opcode is returned. 

If the received command contains a negative opcode, the command is treated as a system command and 
the appropriate system function is invoked. If the appropriate system command has not been previously 
initi^ized by a call to PMenable, the command is ignored. In any case, PMgetcmd will consume all 
system commands until a user (positive opcode) command is read from the input FIFO. 

NOTES 

PMgetcmd can only be called from a pixel node. 

Unlike pipe nodes, pixel nodes may only receive commands from the FIFO. 

PMgetcmd is implemented as a macro. 

SEE ALSO 

PMcommand(4N) 
PMenable(3N) 
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NAME 

PMgetdata - get data from a pipe node FIFO 

SYNOPSIS 

#include <pxm.h> 

void PMgetdataO 

DESCMPTION 

PMgetdata reads parameters of a command from the input FIFO. The parameters are placed in the 
array pointed to by PMcommand.data j)tr. 

NOTES 

PMgetdata can only be called from a pipe node. 

PMgetdata must be preceded by a call to PMgetop. 

SEE ALSO 

PMcommand(4N) 

PMgetop(3P) 

PMputdata(3P) 
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NAME 

PMgetop - get opcode and parameter count from input FIFO of a pipe node 

SYNOPSIS 

#indude <pxin.h> 

short PMgetopO 

DESCRIPTION 

PMgetop loads an opcode and parameter count from the input FIFO and stores them in the global 
PMcommand structure. It returns the opcode. 

If the received command contains a negative opcode, the command is treated as a system command and 
the appropriate system function is invoked. If the appropriate system command has not been previously 
initialized by a call to PMenable, the command is passed on to the output FIFO of this pipe node. In 
any case, PMgetop will consume all system commands until a user (positive opcode) command is read 
from the input FIFO. 

NOTES 

PMgetop can only be called from a pipe node. 

PMgetop must be followed by a call to PMgetdata if PMcommand.count is non-zero. 

PMgetop is implemented as a macro. 

SEE ALSO 

PMcommand(4N) 
PMenable(3N) 
PMgetdata(3P) 
PMputop(3P) 
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NAME 

PMgetpix - read a pixel from the current buffer 

SYNOPSIS 

#include <pxm.h> 

short *PMgetpix(scrn, i, j, color) 
PMsubscrn *scrn; 
short i, j; 
PMpixeltype * color; 

DESCRIPTION 

PMgetpix reads a single pixel from the frame buffer, scrn is a pointer to an initialized PMsubscrn 
structure corresponding to the subscreen from which the pixel is read. 

i andy are subscreen coordinates with the following legal ranges: 

i [0, PMimax] 
j [0,PMjmax] 

PMimax and PMjmax are set to the appropriate value for the current model by system initialization, 
(see the DEVtools User's Guide for more information on subscreen ranges). 

Values beyond these ranges will generate unpredictable results. 

color is a pointer to a PMpixeltype structure whose red, green, blue and overlay components will be 
loaded with the pixel data contained at {i,J) in scrn, 

PMgetpix returns a pointer to the next pixel on the given row (/+1,7). This pointer can be used by 
PMqget for more efficient frame buffer access. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

SEE ALSO 

PMputpix(3X) 
PMqget(3X) 



Pixel Machines Last change: Version 1.1 



PMgetrow(3X) 



DEVtools 
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NAME 



PMgetrow, PMgetcol, PMputrow, PMputcoI - read or write a scanline or scancolumn from pixel 
memory without subscreens 



SYNOPSIS 

#include <pxm.h> 

void PMgetrow(buf, row, col, npix) 
PMpbceltype *buf; 
int row, col, npix; 

void PMgetcol(buf, row, col, npix) 
PMpixeltype *buf; 
int row, col, npix; 

void PMputrow(buf, row, col, npix) 
PMpixeltype *buf; 
int row, col, npix; 

void PMputcol(buf, row, col, npix) 
PMpixeltype *buf; 
int row, col, npix; 

DESCRIPTION 

These four functions implement reading and writing pixels in subscreen- independent space. That is, 
these routines treat pixel memory as a single block of pixels and alternate access to subscreens as 
needed to preserve this illusion. Thus, in a 916, for example, instead of using PMgetscan and calling it 
four times with each of the four 128 by 128 subscreens, PMgetrow can be called once on a 256 by 256 
buffer of pixels without the use of subscreens. This abstraction is useful for working in deinterleaved 
pixel space (e.g., filtering code). Either rows or columns can be accessed with these four functions. 

For a full screen image, the size of subscreen-independent pixel memory is: 



model cols rows 


964X 


160 


128 


964 


128 


128 


.940/932 


128 


256 


920/916 


256 


256 



PMgetrow and PMputrow read or write a row of pixels at a time, while PMgetcol and PMputcoI read 
or write columns. 

buf is a buffer of pixels to write to pixel memory ( PMputrow, PMputcoI ) or read from pixel memory 
( PMgetrow, PMgetcol ). The buf array must be large enough to store the requested pixels. 

col and row are coordinates in subscreen- independent space. The number of pixels is specified in npix. 
Note that each pixel will take up 8 bytes (sizeof (PMpixeltype)) so few/ must be 8 times npix. 

To map from screen space to subscreen- independent processor space the coordinate conversion macros 
(PMilo, PMihi, PMjlo, PMjhi), etc. should be used with the global PMrealscrn subscreen pointer. 
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NOTES V 

Subscreen- independent space is only an abstraction on top of subscreens. Although these routines do 
not use PMsubscrn pointers, they read and write pixels using subscreens, alternating between sub- 
screens when needed. In most cases using the subscreen oriented routines will be faster because pixels 
are accessed linearly. 

Refer to PMzbrk(3X) for page registers used. 

SEE ALSO 

PMgetscan(3X) 
PMputscan(3X) 



( 



( 



Pixel Machines Last change: Version LI 



PMgetscan(3X) DEVtools PMgetscan(3X) 



NAME 

PMgetscan - read a scanline from a subscreen 

SYNOPSIS 

#include <pxm.h> 

void PMgetscan(scrn, buf, row, col, npix) 
PMsubscrn *scrn; 
PMpixeltype *buf; 
short row, col, npix; 

DESCRIPTION 

PMgetscan reads a row of npix pixels starting at (col, row) in subscreen scrn into the buffer buf, which 
must be large enough to hold the pixels. 

scrn is a pointer to an initialized subscreen pointer, col and row are subscreen coordinates in the fol- 
lowing legal ranges: 

col [OJ^Mimax] 
row [OJ^Mjmax] 

PMimax and PMjmax are set to the appropriate value for the current model by system initialization (see 
the DEVtools User's Guide for more information on subscreen ranges). 

Values beyond these ranges can generate unpredictable results. 

SEE ALSO 

PMgetcol(3X) 

PMgetrow(3X) 

PMputscan(3X) 
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NAME 

PMgetzaddr - load a page register and return an address to a section of DRAM 

SYNOPSIS 

#include <pxm.h> 

char *PMgetzaddr(desc) 
PMzdesc desc; 

DESCRIPTION 

PMgetzaddrO is called to gain access to the portion of DRAM memory allocated by PMgetzdesc via a 
pointer and page register, desc is the Z memory descriptor returned from a previous call to 
PMgetzdesc. 

A table of available page registers is maintained by PMgetzaddr. Page registers through 13 are avail- 
able by default. Registers may be blocked by calls to the macros PMblockregO, PMavailregQj 
PMsetlowregO and PMset_hireg(). The table is searched to see if the IK row containing the memory 
to be accessed has been loaded into a page register. If the row has already been loaded, the number of 
accesses using that page register is incremented and the address is returned. If the row is not already 
loaded, an unaccessed page register is searched for and loaded with the page descriptor, if such a page 
register is found. The number of accesses to the page register is then incremented. 

If no page registers are available, it will be necessary to call PMfreezaddr to free one up and tem- 
porarily restrict access to that block. By careful use of PMfreezaddr and PMgetzaddr and knowing 
how many page registers are available, it should be possible to never run out of page registers. 

RETURNS 

PMgetzaddrO returns a pointer to die valid memory address, if a page register can be found. NULL is 
returned on failure. 

NOTES 

If PMfreezaddrO is called with the PMzdesc returned by PMgetzaddrO, and PMgetzaddrO is called 
again with the same PMzdesc, the value of the returned pointer may change, but the contents of the 
memory pointed to will not be changed. 

Unpredictable results can occur if the memory past the end of the allocated block is accessed. 

SEE ALSO 

PMfreezaddr(3X) 

PMgetzdesc(3X) 

PMzbrk(3X) 

PMblock_reg(3X) 

PMavaa_reg(3X) 

PMset_lowreg(3X) 

PMset hireg(3X) 
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NAME 

PMgetzbuf - read a float value from the Z buffer 

SYNOPSIS 

#include <pxm.h> 

float *PMgetzbuf(scrn, i, j, zptr) 
PMsubscrn *scrn; 
short i, j; 
float *zptr; 

DESCRIPTION 

PMgetzbuf reads a single value from Z buffer memory, scrn is a pointer to an initialized PMsubscrn 
structure corresponding to the subscreen from which the value is to be read. 

/ andy are subscreen coordinates with the following legal ranges: 

/ [0, PMimax] 
j [0,PMjmax] 

PMimax and PMjmax are set lo the appropriate value for the current model by system initialization 
(see the DEVtools User's Guide for more information on subscreen ranges). 

Values beyond these ranges will generate unpredictable results. 

zptr is a pointer to a floating point number to be written with the Z value contained at {UJ) in scrn, 

PMgetzbuf returns a pointer to the next Z value on the given row (Z+lj). This pointer can be used by 
PMqzget for more efficient Z buffer access. 

For even faster access, the pointer returned can be used directly (unlike the pointer returned from 
PMgetpix) because Z buffer memory is fully mapped. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

The pointer returned can be cast to other types to allow the Z memory to be used for chca^, int and other 
data types. 

EXAMPLE 

PTR=PMgetzbuf (scrn^ i^ j^ zval 
z2=ptr++ 
z3=ptr++ 

SEE ALSO 

PMgetpix(3X) 

PMputzbuf(3X) 

PMqzget(3X) 

PMzget(3X) 
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NAME 

PMgetzdesc, PMzdesc_valid - allocate a DRAM block 

SYNOPSIS 

#include <pxm.h> 

PMzdesc PMgetzdesc(numbytes) 
int numbytes; 

PMzdesc_valid(desc) 
PMzdesc desc; 

DESCRIPTION 

PMgetzdescO is called after PMzbrkQ has reserved the DRAM memory resources to allocate memory 
in blocks up to 1024 bytes, numbytes is the requested number of bytes, which must be less than or 
equal to 1024. The allocated memory is aligned on 4 byte boundaries. 

PMgetzdesc returns a memory descriptor, of type PMzdesc, that contains two elements of addressing 
information. One element contains the number of the IK block that holds the first available memory, 
and the other contains the offset of that memory from the beginning of that block. The offset is given 
in units of 4 bytes. 

Memory is allocated from the beginning of the section reserved by PMzbrkQ until the end of DRAM. 
No block may wrap over a IK boundary, therefore, PMgetzdesk may have to skip over memory to 
guarantee this. Because of this, it is advisable to allocate memory in chunks that divide into 1024 
evenly. Once a block of memory is allocated with PMgetzdesc it cannot be freed, except by reinitializ- 
ing with a call to PMzbrk, which then starts the allocation process from the beginning. 

In order to actually gain access to the memory being allocated, the descriptor must be used in a subse- 
quent call to PMgetzaddrQ. 

RETURNS 

If successful, PMgetzdesc returns a descriptor of type PMzdesc, as described above. If there is no 
more reserved DRAM left or if the portion left is smaller than the numbytes requested, both elements of 
the returned descriptor are zero. Validity of a descriptor can be tested with the macro 
PMzdesc_valid(desc), where desc is the descriptor being tested. The value is non-zero if the result is 
valid. 

NOTES 

Requesting more than 1024 bytes can produce unpredictable results. 

SEE ALSO 

PMgetzaddr(3X) 

PMfreezaddr(3X) 

PMzbrk(3X) 
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NAME 

PMhost_exit - send a message to the host that signals the completion of a Pixel Machine program 

SYNOPSIS 

void PMhostexitO 

DESCRIPTION 

PMhostexit sends a message to the host that causes the DEVpoUnodes function to return to the 
caller. This is usually used to signal the completion of a Pixel Machine program, but may also be used 
in other applications where the Pixel Machine may want to request that DEVpoII nodes return to the 
caller. 

NOTES 

If devprint is running on the host, PMhostexit will cause it to terminate. 

SEE ALSO 

devprint(l) 
DEVpoll nodes(3H) 
DEVwait exit(3H) 



Pixel Machines Last change: Version LI 



PMieee_dsp ( 3M ) DEVtools PMieee_dsp ( 3M ) 



NAME 

PMieeedsp - convert ffiEE float to DSP float 

SYNOPSIS 

#include <libmath.h> 

float *PMieee_dsp(len, ptr) 
int len; 
float *ptr; 

DESCMPTION 

The len floating point numbers in IEEE format stored at ptr are converted to DSP32 format. A pointer 
immediately following the end of the array (ptr+len) is returned. 

SEE ALSO 

PMlong_dsp(3M) 
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NAME 

PMihi - map from screen space (xmax) to processor space (ihi) 

SYNOPSIS 

#include <pxm.h> 

int PMihi(scrn, x) 
FMsubscrn *scrn; 
float x; 

DESCRIPTION 

PMihi performs the mapping from screen space to processor space. The domain transformation that 
maps from Cartesian (x,y) screen space to (/ J) processor space is as follows: 

i = m-(x - Ox) 

j = ^(y-0y) 

where Nx and Ny are the numbers of processors in the x and y directions, respectively, and Ox and Oy 
are the x and y offsets into the processor array, respectively. PMihi converts a screen space coordinate 
X to a processor space coordinate / that will guarantee satisfying the condition : 

i Nx + Ox <x 

This ensures that all / values generated will map to screen coordinates less than or equal to jc. The i 
value is always used as the last valid pixel to be rendered by a processor. 

NOTES 

PMihi is implemented as a macro. 

SEE ALSO 

DEVtools User's Guide 
PMilo(3X) 
PMjlo(3X) 
PMjhi(3X) 
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NAME 

PMilo - map from screen space (xmin) to processor space (ilo) 

SYNOPSIS 

#include <pxmeh> 

int PMilo(scrn, x) 
PMsubscrn *scrii; 
float x; 

DESCRIPTION 

This macro performs the mapping from screen space to processor space. The domain transformation 
that maps from Cartesian (x,y) screen space to (ij) processor space is as follows: 

« = 7^ (^ - Ox) 

J = i^(y-Oy) 

where Nx and Ny are the numbers of processors in the x and y directions, respectively, and Ox and Oy 
are the x and y offsets into the processor array, respectively. 

PMilo converts a screen space coordinate jc to a processor space coordinate / that guarantees satisfying 
the condition : 

i Nx -^ Ox >x 

This ensures that all / values generated will map to screen coordinates greater than or equal to x. The / 
value is always used as the first valid pixel to be rendered by a processor. 

NOTES 

PMilo is implemented as a macro. 

SEE ALSO 

DEVtools User's Guide 
PMihi(3X) 
PMjlo(3X) 
PMjhi(3X) 
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NAME 

PMint^color - macro that converts an integer to an internal color value 

SYNOPSIS 

#include <pxm.h> 

int PMiiit_color(i) 
int i; 

DESCRIPTION 

PMint_color is a macro that converts an integer in the range - 255 to an internal color value. Results 
for input values outside of the supported range are undefined. 

SEE ALSO 

PMcolor_int(3N) 
PMcolorJ[oat(3N) 
PMfloat color(3N) 
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NAME 

PMinterleave - interleave or deinterleave a block 



SYNOPSIS 
















#mclude <pxm.h> 
















#include <sysmsg.h> 
















void PMinterleave(mode, 


dir, 


X, 


y^ 


nx, 


ny, 


ram 


) 


int mode; 
















int dir; 
















int X, y; 
















int nx, ny; 
















int ram; 

















DESCRIPTION 

PMinterleaveO deinterleaves or interleaves a rectangular region of the screen starting at (x,y) in screen 
space, for a size of nx pixels by ny scanlines in one dimension. The values of x and y are restricted to 
multiples of the number of processors in the x and >' directions (PMnx, PMny), respectively. 

nx and ny must be multiples of PMnx squared and PMny squared, respectively. 

mode is either PM_INTERLEAVE or PMDEINTERLEAVE, and specifies if this is an interleave or 
deinterleave operation. 

dir is the dimension, either PM__ROW_INT or PM_COL_INT for horizontal or vertical. 

X and y are the upper left hand coordinate of the block in screen space and are in the range [0- 
(PMxmax-1)] and [O-(PMymax-l)]. 

nx and ny are the number of pixels in the x and y direction, respectively, and are in the range [0- 
PMxmax)] and [0-PMxmax)]. 

The ram parameter is one of: 

PMVRAMIBUFFER: uses VRAMl instead of VRAMO on a 932 and higher. 

If in double buffer mode, (i,j) must be within the correct limits, otherwise they can be 
larger as with PM_FRONT_BUFFER. 

PM_BACK_BUFFER: the currently non-displayed buffer. 

PMFRONTBUFFER: the currently displayed buffer. Note, however, that in an 

appropriately large model in single buffer mode, you can specify ij out of bounds, e.g., 
on a 964 (512,512) will work. 

PMZRAMBUFFER: uses ZRAM without subscreens. 

To interleave (deinterleave) in two dimensions call PMinterleaveO twice with the same parameters 
except change dir from PMROW to PMCOL (or vice-versa). 
NOTES 

For PMinterleaveO to work, the Pixel Machine must be equipped with the necessary SIO hardware. 

This function changes the SIO direction. The host must be polling via a call to DEVpoIlnodesO or 
running the devprint(l) utility. PMpsync() is called internally. 

PMinterleaveO needs 4200 bytes available on the stack. 
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Saves and restores any page registers that it uses. 
SEE ALSO 

PMpsync(3X) 

PMsiodir(3X) 

PMmsg_exchange(3X) 

PMmsg_setup(3X) 

PMsiomit(3X) 

DEVpoll nodes(3S) 

devprmt(l) 



c 
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NAME 

PMjhi - map from screen space (ymax) to processor space Qhi) 

SYNOPSIS 

#include <pxm.h> 

int PMjhi(scrii, y) 
FMsubscrn *scrn; 
float y; 

DESCRIPTION 

PMjhi performs the mapping from screen space to processor space. The domain transformation that 
maps from Cartesian (x,y) screen space to (i,j) processor space is as follows: 

^' = TOT (^ - ^^> 

where Nx and Ny are the numbers of processors in the x and y directions, respectively, and Ox and Oy 
are the x and y offsets into the processor array, respectively. 

PMjhi converts a screen space coordinate y to a processor space coordinate j that will guarantee satis- 
fying the condition : 

j Ny -^Oy <y 

This ensures that all j values generated will map to screen coordinates less than or equal to y . The j 
value is always used as the last valid pixel to be rendered by a processor. 

NOTES 

PMjhi is implemented as a macro. 

SEE ALSO 

DEVtools User's Guide 
PMilo(3X) 
PMihi(3X) 
PMjlo(3X) 
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NAME 

PMjlo - map from screen space (ymin) to processor space (jlo) 

SYNOPSIS 

#indude <pxm.h> 

int PMjlo(scrn, y) 
PMsubscrn scrn; 
float y; 

DESCRIPTION 

PMjlo performs the mapping from screen space to processor space. The domain transformation that 
maps from cartesian (x,y) screen space to (ij) processor space is as follows: 



i = WcOc - Ox) 
J = -Ny(y^Oy) 



where Nx and Ny are the numbers of processors in the x and y directions, respectively, and Ox and Oy 
are the x and y offsets into the processor array, respectively. 

PMjlo converts a screen space coordinate y to a processor space coordinate j that will guarantee satisfy- 
ing the condition : 

j Ny -^Oy >y 

This ensures that all j values generated will map to screen coordinates greater than or equal to y . The j 
value is always used as the first valid pixel to be rendered by a processor. 

NOTES 

PMjlo is implemented as a macro. 

SEE ALSO 

DEVtools User's Guide 
PMilo(3X) 
PMihi(3X) 
PMjhi(3X) 
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NAME 

PMldot - specialized dot product for light sources 

SYNOPSIS 

#include <libmath.h> 

float PMldot(vO, vl) 
float v0[3], vl[3]; 

DESCRIPTION 

PMldot calculates the dot product of vectors vO and v7. If the result is negative, PMldot returns zero, 
otherwise it returns the value of the dot product. 
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NAME 

PMlongdsp - convert an array of longs to float 

SYNOPSIS 

#iiiclude <libmath.h> 

long ♦PMlongdspClen, ptr) 
int len; 
float *ptr; 

DESCMPTION 

The len long numbers stored at ptr are converted to float. A pointer immediately following the end of 
the array (ptr+len) is returned. 

SEE ALSO 

PMieee_dsp(3M) 
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NAME 

PMmsgexchange - send and receive data packet over serial links 

SYNOPSIS 

#include <pxm.h> 

void PMmsg_exchange(inbuf, outbuf, length) 
float *mbuf, *outbuf; 
int length; 

DESCRIPTION 

PMmsgexchange sends length floats from outbuf out the serial link, then waits to receive length floats 
into inbuf on the link. Because of restrictions imposed by hardware, all nodes must exchange the same 
amount of data at the same time; the correct procedure to do this uses the PMmsgsetup and PMpsync 
routines as follows: 

float inbuf [SIZE], outbuf [SIZE] ; 

PMmsg_setup (inbuf ) ; 

PMpsync ( ) ; 

PMmsg_exchange (inbuf , outbuf, SIZE) ; 

Any data type may be exchanged over the link, but the packet size must be a multiple of 4 bytes 
(sizeofifloat)). 

NOTES 

The inbuf pointers passed to PMmsg_setup and PMmsgexchange must be the same or 
PMmsgexchange may never return. 

PMsioinit must be called before any other use of the serial links is made. 

SEE ALSO 

PMmsg_setup(3X) 

PMpsync(3X) 

PMsioinit(3X) 
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NAME 

PMmsg_setup - set serial DMA input pointer 

SYNOPSIS 

#include <pxm.h> 

void PMmsgsetup (buffer) 
float * buffer; 

DESCRIPTION 

PMmsg_setup sets the serial DMA input pointer to the supplied buffer. The pointer must be set and all 
processors synchronized using PMpsync before PMmsgexchange functions correctly. 

SEE ALSO 

PMmsg_exchange(3X) 

PMpsync(3X) 

PMsioiiiit(3X) 
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NAME 

PMmyx - test if a given screen space coordinate is in processor space 

SYNOPSIS 

#include <pxm.h> 

int PMmyx(scrii, x) 
PMsubscrn *scrn; 
float x; 

DESCRIPTION 

PMmyx tests if the screen space coordinate x is in the processor subscreen scrn and returns TRUE or 
FALSE accordingly. 

NOTES 

PMmyx is implemented as a macro. 

SEE ALSO 

PMmyyOX) 

PMxat(3X) 

PMyat(3X) 
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NAME 

PMmyy - test if a given screen space coordinate is in processor space 

SYNOPSIS 

#iiiclude <pxm.h> 

int PMmyy(scrii, y) 
PMsubscrn *scrii; 
float y; 

DESCRIPTION 

PMmyy tests if the screen space coordinate y is in the processor subscreen scrn and returns TRUE or 
FALSE accordingly. 

NOTES 

PMmyy is implemented as a macro. 

SEE ALSO 

PMmyx(3X) 

PMxat(3X) 

PMyat(3X) 
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NAME 

PMnorm - normalize a 3D vector and return its length 

SYNOPSIS 

#include <libmath.h> 

float PMnorm(v) 
float v[3]; 

DESCRIPTION 

PMnorm normalizes the vector v, and overwrites v with this new value. It returns the inverse of the 
length of vector v prior to normalization. 
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NAME 

PMoutpir - output a value to the PIR register 

SYNOPSIS 

void PMoutpir(val) 
short val; 

DESCRIPTION 

PMoutpir waits until the PIR is empty and then writes val to it. The wait ensures that the host has read 
all values written with previous calls to PMoutpir. 

This function is a low level I/O routine; most applications should use PMusermsgO instead. 

SEE ALSO 

PMusermsg(3N) 
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NAME 

PMoverlay - turn overlay on or off 

SYNOPSIS 

void PMoverlay(flag) 
int flag; 

DESCRIPTION 

PMoverlay sets the overlay bit in the pixel node flag register to turn the overlay capability on or off. 

If ^^ is zero, overlay is disabled (the default). A nonzero value for flag turns overlay on. 

NOTES 

In addition to calling PMoverlay, DEVpixelmodeoverlay must also be called on the host to set the 
desired overlay mode. 

SEE ALSO 

DEVpixel_mode_overlay(3S) 
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NAME 

PMpagereg, PMdesc, PMxlate - macros to manipulate page registers used to access video and Z 
memory 

SYNOPSIS 

#include <pxm.h> 
#include <pixel.h> 

int PMpagereg(reg_number) 
int regnumber; 

int PMdesc(bank, mode) 
int bank; 

int mode; 

int PMxlate(reg_number) 
int regnumber; 

DESCRIPTION 

These macros are used to manipulate the page registers used to access the video memory and Z memory. 

The page registers are located in a reserved memory area. The PMpagereg macro is used to generate 
the address of a specified page register, regjiumber is the number of the register whose address is to 
be supplied and is in the range [0-15]. 

The PMdesc macro is used to generate the value to be stored into a page register in order to access a 
given bank of memory, bank designates the bank of memory to be accessed and must be one of: 

PM_ZMEM - Z memory 

PM_^RGO - red/green bank of VRAMO 

PMBOO - blue/overlay bank of VRAMO 

PM_RG1 - red/green bank of VRAMl 

PM_B01 - blue/overlay bank of VRAMl 

mode must be either PMFIXROW or PM FIXCOL; PMFIXROW is used to access the pixels of 
a given scan line. PM_FIX_COL is used to access the pixels of a given column. The row number (in 
fixed row mode) or column number (in fixed column mode) is added to the value returned by PMdesc 
to create the descriptor needed to access the desired memory row or column. 

PMxlate generates a pointer than can be used to access the contents of the row or column specified by 
the PMdesc macro. Once a page register has been established, the next 1024 bytes can be accessed 
using the pointer generated by the PMxlate macro. 



EXAMPLE 

The following is an example of these macros. This programs turns on all of the red pixels in VRAMO 
and the blue pixels in VRAMl, and turns off the green pixels in VRAMO and the overlay pixels in 
VRAMl. 

♦include <pxm.h> 
♦include <pixel.h> 

♦define RGREG 6 
♦define BOREG 7 
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PMpagereg(3X) 



main () 

r 




1 

register int 


i; 


register int 


j; 


register int 


*rgptr; 


register int 


*boptr; 


register int 


*rgpagereg; 


register int 


*bopagereg; 



rgpagereg = (int *) PMpagereg (RGREG) ; 
bopagereg = (int *) PMpagereg (BOREG) ; 

for (j = 0; j < 255; ++j) { 

♦ rgpagereg = PMdesc (PM_RGO, PM_FIX__ROW) 
*bopagereg = PMdesc (PM_B01, PM__FIX_ROW) 
rgptr = (int *) PMxlate (RGREG) ; 
boptr == (int *) PMxlate (BOREG) ; 
for (i = 0; i < 255; ++i) { 

*rgptr4-+ = PMint_color (255) 
*rgptr++ = PMint__color (0) ; 
*boptr-f+ = PMint_color (255) 
*boptr4-+ = PMint_color (0) ; 
} 



+ 
+ 



j; 



/* Set red */ 

/* Clear green */ 

/* Set blue */ 

/* Clear alpha */ 



NOTES 



} 

The pixeLh include file can be used with both C and assembler source files. As a result, the macro 
return values are not cast as pointers. For this reason, you must cast the return value of the macros to 
the appropriate pointer type. 

PMpagereg should always be cast as a pointer to an int, PMdesc really does return an integer. 
PMxlate should be cast to an appropriate type based on the application. When dealing with VRAM (as 
opposed to Z memory), the pointer returned by PMxlate is usually a pointer to an int. 

Some of the DEVtOOls pixel node functions set page registers automatically, and other functions rely on 
them. See PMzbrk for the list of page registers used. 

Page registers 14 and 15 are reserved for use by the host for DMA. 

SEE ALSO 

PMzbrk(3X) 



c 
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PMpixaddr ( 3X ) DEVtools PMpixaddr ( 3X ) 



NAME 

PMpixaddr - generate a pointer to a specific pixel 

SYNOPSIS 

#include <pxm.h> 

short *PMpixaddr(scrn, i, j) 
PMsubscrn *scrn; 
short i, j; 

DESCRIPTION 

PMpixaddr generates addresses of pixels in the frame buffer, scrn is a pointer to an initialized 
PMsubscrn structure corresponding to the subscreen in which the desired pixel lies. 

/ and j are subscreen coordinates with the following legal ranges: 

i [0,PMimax] 
; [0,PMjmax] 

PMimax and PMjmax are set to the appropriate value for the current model by system initialization 
(see the DEVtools User's Guide for more information on subscreen ranges). 

Values beyond these ranges will generate unpredictable results. 

PMpixaddr returns a pointer to the pixel at coordinates (rj) in subscreen scrn. This pointer can be used 
by PMqget and PMqput for more efficient frame buffer access. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

SEE ALSO 

PMgetpix(3X) 
PMputpix(3X) 
PMqget(3X) 
PMqput(3X) 
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PMpow ( 3M ) DE Vtools PMpow ( 3M ) 



NAME 

PMpow - power function 

SYNOPSIS 

#include <libmath.h> 

float PMpow(x, y) 
float X, y; 

DESCRIPTION 

PMpow returns the quantity x^ y, where both x and y are floating point values, x should be of positive 
magnitude. 

SEE ALSO 

PMx_exp_n(3M) 
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PMpsync ( 3X ) DE Vtools PMpsync ( 3X ) 



NAME 

PMpsync - wait for all pixel processors to synchronize 

SYNOPSIS 

void PMpsyncO 

DESCRIPTION 

PMpsync is a processor synchronization primitive. Once called, it will not return until all pixel nodes 
have called PMpsync. 

NOTES 

PMpsync uses the PMFLAG hardware signal; thus PMflagled and PMpsync should not be used in the 
same program. 

SEE ALSO 

PMvsync(3X) 
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NAME 

PMputcmd - write opcode, parameter count, and parameters to the output FIFO of a pipe node 

SYNOPSIS 

#mdude <pxm.h> 

void PMputcmdO 

DESCRIPTION 

PMputcmd copies the opcode, count, and parameters from the global PMcommand structure to the 
output FIFO. 

NOTES 

PMputcmd can only be called from a pipe node program. 

SEE ALSO 

PMcommand(4N) 

PMgetdata(3P) 

PMgetop(3P) 

PMputdata(3P) 

PMputopOP) 
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PMputdata(3P) DEVtools PMputdata(3P) 



NAME 

PMputdata - write parameters to the output FIFO of a pipe node 

SYNOPSIS 

#include <pxm.h> 

void PMputdataO 

DESCRIPTION 

PMputdata copies the parameters from the global PMoommand structure to the output FIFO. 

NOTES 

PMputdata can only be called from a pipe node program. 

PMputdata must be preceded by a call to PMputop. 

SEE ALSO 

PMcominand(4N) 

PMgetdata(3P) 

PMgetop(3P) 

PMputcmd(3P) 

PMputop(3P) 
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PMputop ( 3P ) DE Vtools PMputop ( 3P ) 



NAME 

PMputop - write opcode and parameter count to the output FIFO of a pipe node 

SYNOPSIS 

#mclude <pxm.h> 

void PMputopO 

DESCRIPTION 

PMputop copies the opcode and parameter count from the global PMcommand structure to the output 
FIFO. 

NOTES 

PMputop can only be called from a pipe node program. 

PMputop must be followed by a call to PMputdata if PMcommand.count is non-zero. 

SEE ALSO 

PMcommaiid(4N) 

PMgetdata(3P) 

PMgetop(3P) 

PMputcmd(3P) 

PMputdata(3P) 
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PMputpix(3X) DEVtools PMputpix(3X) 



NAME 

PMputpix - output a pixel to the current buffer 

SYNOPSIS 

#include <pxm.h> 

short *PMputpix(scrn, i, j, color) 
PMsubscrn *scrii| 
short i, j; 
PMpixeltype *color; 

DESCRIPTION 

PMputpix writes a single pixel to the frame buffer, scrn is a pointer to an initialized PMsubSCrn 
structure corresponding to the subscreen to which the pixel is written. 

/ and j are subscreen coordinates with the following legal ranges: 

/ [0, PMimax] 
j [0,PMjmax] 

PMimax and PMjmax are set to the appropriate value for the current model by system initialization 
(see the DEVtools User's Guide for more information on subscreen ranges). 

Values beyond these ranges will generate unpredictable results. 

color is a pointer to a PMpixeltype structure whose red, green, blue and overlay components are written 
at (/,7) in scrn, 

PMputpix returns a pointer to the next pixel on the given row (/+1 j*). This pointer may be used by 
PMqput for more efficient frame buffer access. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

SEE ALSO 

PMgetpix(3X) 
PMqput(3X) 
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PMputscan(3X) DEV tools PMputscan(3X) 



NAME 

PMputscan - write a scanline to a subscreen 

SYNOPSIS 

#iiiclude <pxin.h> 

void PMputscan(scrn, buf, row, col, npix) 
PMsubscrn *scrn; 
PMpixeltype *buf; 
short row, col, npix; 

DESCRIPTION 

PMputscan writes a row of npix pixels starting at {coUrow) in subscreen scrn from the buffer buf, 

scrn is a pointer to an initialized subscreen pointer, col and row are subscreen coordinates in the fol- 
lowing legal ranges: 

col [OJ^Mimax] 
row [OyPMjmwc] 

PMimax and PMjmax are set to the appropriate value for the current model by system initializa- 
tion (see the DEVtOOls User's Guide for more information on subscreen ranges). 

Values beyond these ranges can generate unpredictable results. 

SEE ALSO 

PMgetscan(3X) 
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PMputzbuf(3X) DEVtools PMputzbuf(3X) 



NAME 

PMputzbuf - write a float value to the Z buffer 

SYNOPSIS 

#include <pxm.h> 

float *PMputzbuf( scrn, i, j, zval ) 
PMsubscrn *scrn; 
short i, j; 
float zval; 

DESCRIPTION 

PMputzbuf writes a single value to Z buffer memory, scrn is a pointer to an initialized PMsubSCrn 
structure corresponding to the subscreen from which the value is to be read. 

/ and 7 are subscreen coordinates with the following legal ranges: 

i [0, PMimax] 
j [0,PMjmax] 

PMimax and PMjmax are set to the appropriate value for the current model by system initialization 
(see the DEVtools User's Guide for more information on subscreen ranges. 

Values beyond these ranges will generate unpredictable results. 

zval is a floating point value to be written at (ij) in scrn, 

PMputzbuf returns a pointer to the next Z value on the given row (i+l,y). 

The pointer returned can be used directly (unlike the pointer returned from PMputpix), because Z buffer 
memory is fully mapped. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

The pointer returned can be cast to other types to allow Z memory to be used for char, int, and other 
data types. 

EXAMPLE 

ptr=PMputzbuf (scrn^ i/jf zval) ; 

*ptr++=zval; 

*ptr++=zval; 

SEE ALSO 

PMgetzbuf(3X) 

PMputpix(3X) 

PMzput(3X) 
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NAME 

PMqcopyztoz - copy from one section of DRAM to another 

SYNOPSIS 

#include <pxm.h> 

void PMqcopyztoz(start i, startj, leni, lenj, desti, destj) 

int starti; 

int startj; 

int leni; 

int lenj; 

int desti; 

int destJ; 

DESCRIPTION 

PMqcopyztoz copies a rectangular section of DRAM, lenj long words by lenj rows, from coordinates 
startj and startj to another section of DRAM buffer, desti and destJ are the destination coordinates, 
and correspond to startj and startj, respectively. PMqcopyztoz is faster and takes less code space 
than PMcopyztoz(3), but cannot handle overlapping copies. While some overlapping copies may 
succeed, care should be taken so that the source area and destination areas of ZRAM are disjoint. 

The J arguments are in units of 4 byte long words, e.g., 1 byte for each of red, green, blue and overlay, 
or the size of one float. Thus, if startj is set to 1, and lenj is set to 1,4 bytes will be copied on each 
row, starting at an offset of 4 bytes from the beginning of the row. In the J direction, one row 
corresponds to one row, with no multiplicative factors. 

SEE ALSO 

PMcopyztoz(3X) 
PMcopyztov(3X) 
PMcopyvtoz(3X) 
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PMqget ( 3X ) DE Vtools PMqget ( 3X ) 



NAME 

PMqget - quick read of a pixel from the current buffer 

SYNOPSIS 

#include <pxm.h> 

short *PMqget(color, ptr) 
PMpixeltype *color; 
short *ptr; 

DESCRIPTION 

PMqget reads a single pixel from the frame buffer, ptr is a pointer to the pixel location from which the 
pixel is to be read; color is a pointer to a PMpixeltype structure which is written with the pixel located 
at ptr. 

PMqget returns a pointer to the next pixel on the given row. This value may be used in subsequent 
calls to PMqget. 

NOTES 

PMqget uses a pointer created by PMgetpix, PMvOget and other routines. PMqget uses the same page 
registers as the routine that generated the pointer. The user must ensure that the page registers are not 
corrupted while PMqget is in use. 

Refer to PMzbrk(3X) for page register use. 

SEE ALSO 

PMgetpix(3X) 

PMpixaddr(3X) 

PMqput(3X) 
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PMqput(3X) DEVtools PMqput(3X) 



NAME 

PMqput - quick write of a pixel to the current buffer 

SYNOPSIS 

#include <pxm,h> 

short *PMqput(color, ptr) 
PMpixeltype *color; 
short *ptr; 

DESCRIPTION 

PMqput writes a single pixel from the frame buffer, ptr is a pointer to the pixel location to which the 
pixel is to be written; color is a pointer to a PMpixeltype structure containing the pixel to be written at 
ptr, 

PMqput returns a pointer to the next pixel on the given row. This value may be used in subsequent 
calls to PMqput. 

NOTES 

PMqput uses a pointer created by PMputpix, PMvOput and other routines. PMqput uses the same 
page registers as the routine that generated the pointer. The user must ensure that the page registers are 
not corrupted while PMqput is in use. 

Refer to PMzbrk(3X) for page register use. 

SEE ALSO 

PMpixaddr(3X) 

PMputpix(3X) 

PMqget(3X) 
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PMrdyled ( 3X ) DEVtools PMrdyled ( 3X ) 



NAME 

PMrdyled - turn the PMRDY LED on or off 

SYNOPSIS 

#include <pxm.h> 

void PMrdyled(flag) 
short flag; 

DESCRIPTION 

PMrdyled clears (if flag == 0) or sets (it flag != 0) the PMRDY LED for this node. 

NOTES 

PMrdyled uses the PMRDY hardware signal; thus PMrdyled and PMvsync should not be used in the 
same program. 

SEE ALSO 

PMflagled(3X) 

PMvsync(3X) 
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PMrdyoff ( 3X ) DEVtools PMrdyoff ( 3X ) 



NAME 

PMrdyoff - turn the ready signal off 

SYNOPSIS 

void PMrdyoffO 

DESCRIPTION 

PMrdyoff turns off the DEV_FLAG signal used by PMvsync. It must be called some time after calling 
PMvsync and before another PMvsync is done. 

NOTES 

The purpose of separating PMvsync and PMrdyoff is to allow as much time as possible for user code 
after vertical retrace begins. 

SEE ALSO 

PMvsync(3X) 
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NAME 

PMsetsem - set the semaphore 

SYNOPSIS 

void PMsetsem(value) 
short value; 

DESCRIPTION 

PMsetsem waits for the software semaphore to be cleared by the host, then sets it to the passed value. 

SEE ALSO 

PMwaitsem(3N) 
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PMsin ( 3M ) DE Vtools PMsin ( 3M ) 



NAME 

PMsin - trigonometric function 

SYNOPSIS 

#mclude <libmath.h> 

float PMsin(theta) 
float theta; 

DESCMPTION 

PMsin returns the sine of theta. 

theta must be in radians and be between -Pi/2 and +Pi/2. 
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NAME 

PMsiodir - set serial I/O link direction 

SYNOPSIS 

#include <sysmsg.h> 

void PMsiodir(dir) 
short dir; 

DESCRIPTION 

PMsiodir sends a message to the host monitor process to set the serial I/O (SIO) link direction, dir 
must be one of: 

PM_MSG_SERIAL_NORTH 
PM_MSG_SERIAL_SOUTH 
PM_MSG_SERIAL_EAST 
PM_MSG_SERIAL_WEST 

These constants are defined in sysmsg.h. 

For it to work correctly, all the pixel nodes must call PMsiodir. PMsiodir calls PMpsync internally to 
synchronize before the host changes the link direction for all the pixel nodes. 

NOTES 

As with all other SIO functions, PMsiodir must only be called from pixel nodes. 

SEE ALSO 

PMmsg_exchange(3X) 
PMmsg_setup(3X) 
PMpsync(3X) 
PMsioinitOX) 



Pixel Machines Last change: Version 1.1 



PMsioinit ( 3X ) DE Vtools PMsioinit ( 3X ) 



NAME 

PMsioinit - initialize serial I/O 

SYNOPSIS 

#include <pxm*h> 

void PMsioinitO 

DESCRIPTION 

PMsioinit configures the serial I/O link for DMA input and polled output. It must be called only once 
before attempting to send messages over the serial links using PMmsgsetupQ and PMmsgexchangeQ. 

SEE ALSO 

PMmsg_setup(3X) 

PMmsg_exchange(3X) 

PMpsync(3X) 
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PMsnglbuff ( 3X ) DE Vtools PMsnglbuff ( 3X ) 



NAME 

PMsnglbuff - disable double buffering mode 

SYNOPSIS 

#include <pxm.h> 

void PMsnglbuffO 

DESCRIPTION 

PMsnglbuff disables double buffering and returns to single buffer mode. This means that all future 
updates using subscreen oriented functions (e.g., PMputpixQ) will occur in the same buffer that is 
displayed. 

PMsnglbuff only needs to be called after a call to PMdblbuff because it is the default mode at start up. 

SEE ALSO 

PMswapbuff(3X) 

PMswapback(3X) 

PMdblbuiT(3X) 
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NAME 

PMsqrt - sqare root function 

S\^OPSIS 

#inclu(le <libmath.h> 

float PMsqrt(x) 
float x; 

DESCRIPTION 

PMsqrt returns the square root of x, x must be >=0. This function is accurate to 6 significant digits. 
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NAME 

PMswap_pipe - switch primary and alternate pipes of a dual pipe system 
PMbuswait - wait until control of the broadcast bus is granted 

SYNOPSIS 

#include <pxm.h> 

void PMswappipeO 
void PMbuswaitO 

DESCRIPTION 

On a dual pipe system, with the pipes operating in parallel mode, one pipe is the primary pipe and the 
other is the alternate pipe. PMswappipe reverses the functions of the two pipes. This is used to bal- 
ance the load between the two pipes. 

PMswap jipe can only be called by the last node of a pipe board (node 8 or 17). When called, 
PMswap_pipe releases the broadcast bus to the alternate pipe It then requests the bus and waits for bus 
access to be granted. 

PMbus_wait loops until control of the bus is granted. This is typically called during the initialization 
phase by the second pipe board, because initial control of the pipe is granted to the first pipe board. 

SEE ALSO 

DEVswap_pipe(3P) 
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PMswapback(3) DEVtools PMswapback ( 3 ) 



NAME 

PMswapback - swap meaning of back buffer 

SYNOPSIS 

#include <pxm.h> 

void FMswapback( ) 

DESCRIPTION 

PMswapback swaps the back and front buffer with respect to update, but does not change the visible 
buffer. In double buffer mode this means that the front buffer is also the update the buffer. In single 
buffer mode this means that the back buffer is updated. This functions will change the behavior of all 
functions that use a PMsubscrn argument to update the current buffer. 

NOTES 

PMswapback is implemented as a macro. 
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PMswapbuff ( 3X ) DEVtools PMswapbuff ( 3X ) 



NAME 

PMswapbuff - swap front and back pixel buffers 

SYNOPSIS 

void PMswapbuffO 

DESCRIPTION 

PMswapbuff exchanges the front (visible) and back pixel buffers; it should be called when a frame has 
been generated in the pixel buffer and must be displayed. PMswapbuff waits for vertical retrace by cal- 
ling PMvsync before swapping and then calling PMrdyoff. 

NOTES 

Double buffering mode must be enabled with PMdblbuff before calling PMswapbuff. 

SEE ALSO 

PMdblbuff(3X) 

PMswapback(3X) 

PMsnglbuff(3X) 

PMvsync(3X) 

PMrdyoff(3X) 
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NAME 

PMusermsg - send a user message to the host 

SYNOPSIS 

void PMus€rmsg(msg) 
short msg; 

DESCRIPTION 

PMusermsgO sends a user defined opcode (a user message) to the host monitor process, msg must be a 
positive short int 

PMusermsgO checks the software semaphore to see if there was a previous PMusermsgO pending and, 
if necessary, waits. Otherwise, PMusermsgO returns immediately. If the message operation must com- 
plete before execution continues, PMwaitsem() should be called. 

SEE ALSO 

PMwaitsem(3N) 

DEVtOOlsC/^er'^ Guide (section on user messages) 
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PMvOget ( 3X ) DE Vtools PMvOget ( 3X ) 



NAME 

PMvOget - read a pixel from buffer 

SYNOPSIS 

#include <pxm.h> 

short *PMvOget(i, j, color) 
short i,j; 
PMpixeltype * color; 

DESCRIPTION 

PMvOgetO reads a single pixel from the frame buffer. Unlike PMgetpix(), the coordinate system used 
allows full access to frame buffer memory. 

i and j are coordinates in the range [0, 255]. Values outside this range will generate unpredictable 
results. 

color is a pointer to a PMpixeltype structure whose red, green, blue and overlay components are loaded 
with the pixel data contained at (/j*) in page of pixel memory. 

PMvOgetO returns a pointer to the next pixel on the given row (i+lj*)- This pointer can be used by 
PMqgetO for more efficient frame buffer access. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

PMvOgetO does not take into account subscreens or front and back buffers. 

SEE ALSO 

PMgetpix(3X) 
PMqget(3X) 
PMv0put(3X) 
PMvlget(3X) 
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PMvOput ( 3X ) DE Vtools PMvOput ( 3X ) 



NAME 

PMvOput - write a pixel to buffer 

SYNOPSIS 

#iiiclude <pxm.h> 

short *PMvOput(l, j, color) 
short i, j; 
PMpixeltype * color; 

DESCMPTION 

PMvOputO writes a single pixel to the frame buffer. Unlike PMputpix(), the coordinate system used 
allows full access to frame buffer memory. 

i and j are coordinates in the range [0, 255]. Values outside this range will generate unpredictable 
results. 

color is a pointer to a PMpixeltype structure which contains the red, green, blue and overlay com- 
ponents to be written at (/,/) in page of pixel memory. 

PMvOputO returns a pointer to the next pixel on the given row (/+!,/). This pointer can be used by 
PMqputO for more efficient frame buffer access. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

PMvOputO does not take into account subscreens or front and back buffers. 

SEE ALSO 

PMputpix(3X) 
PMqput(3X) 
PMv0get(3X) 
PMvlput(3X) 
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PMvlget(3X) DEVtools PMvlget(3X) 



NAME 

PMvlget - read a pixel from buffer 1 

SYNOPSIS 

#include <pxin.h> 

short *PMvlget(i, j, color) 
short i,j; 
PMpixeltype *color; 

DESCRIPTION 

PMvlgetO reads a single pixel from the frame buffer. Unlike PMgetpixQ, the coordinate system used 
allows fiill access to frame buffer memory. 

/ and j are coordinates in the range [0, 255]. Values outside this range will generate unpredictable 
results. 

color is a pointer to a PMpixeltype structure whose red, green, blue and overlay components will be 
loaded with the pixel data contained at (/,y) in page 1 of pixel memory. 

PMvlgetO returns a pointer to the next pixel on the given row (/+l,y). This pointer can be used by 
PMqgetO for more efficient frame buffer access. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

PMvlgetO does not take into account subscreens or front and back buffers. 

SEE ALSO 

PMgetpix(3X) 
PMqget(3X) 
PMvlput(3X) 
PMv0get(3X) 
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PMvlput(3X) DEVtools PMvlput(3X) 



NAME 

PMvlput - write a pixel to buffer 1 

SYNOPSIS 

#include <pxm.h> 

short *PMvlput(i, j, color) 
short i, j; 
PMpixeltype *color; 

DESCRIPTION 

PMvlputO writes a single pixel to the frame buffer. Unlike PMputpixQ, the coordinate system used 
allows full access to frame buffer memory. 

/ and j are coordinates in the range [0, 255]. Values outside this range will generate unpredictable 
results. 

color is a pointer to a PMpixeltype structure which contains the red, green, blue and overlay com- 
ponents to be written at (/,/) in page 1 of pixel memory. 

PMvlputO returns a pointer to the next pixel on the given row (/+!,/). This pointer can be used by 
PMqputO for more efficient frame buffer access. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

PMvlputO does not take into account subscreens or front and back buffers. 

SEE ALSO 

PMputpix(3X) 
PMqput(3X) 
PMvlget(3X) 
PMv0put(3X) 
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PMvsync(3X) DEVtools PMvsync(3X) 



NAME 

PMvsync - synchronize and wait for vertical retrace 

SYNOPSIS 

void PMvsyncO 

DESCRIPTION 

PMvsync is a video synchronization primitive. Once called, it will not return until both of the follow- 
ing conditions are true: 

all pixel nodes have called PMvsync. 

the vertical retrace period has begun. 

NOTES 

PMvsync uses the PM_RDY hardware signal; thus PMrdyled and PMvsync should not be used in the 
same program. 

PMrdyoff must be called after calling PMvsync and before further calls to PMvsync are made. The 
purpose of separating PMvsync and PMrdyoff is to allow as much time as possible for user code after 
vertical retrace begins. 

PMswapbuff uses PMvsync and PMrdyoff internally. 

SEE ALSO 

PMpsync(3X) 
PMrdyoff(3X) 
PMswapbuff(3X) 
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PMwaitsem(3N) DEVtools PMwaitsem(3N) 



NAME 

PMwaitsem - wait for semaphore to clear 

SYNOPSIS 

void PMwaitsemO 

DESCRIPTION 

PMwaitsem polls the software semaphore until it is cleared by the host. It can be used to synchronize 
with the host after calling PMsetsem, or to wait for the host to complete a user message or system mes- 
sage such as printf. 

SEE ALSO 

PMsetsem(3N) 

PMusermsg(3N) 

printfON) 

DEM\oo\sUser's Guide (section on messages) 
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PMx_exp_n ( 3M ) DE Vtools PMx_exp_n ( 3M ) 



NAME 

PMxexpn - integer power function 

SYNOPSIS 

#include <libmath.h> 

float PMx_exp_ii(x, n) 
float x; 
short n; 

DESCRIPTION 

PMx_exp_n returns the quantity x^ n, where n is a positive integer between 1 and 20. 

SEE ALSO 

PMpow(3M) 
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PMxat ( 3X ) DE Vtools PMxat ( 3X ) 



NAME 

PMxat - map subscreen coordinates to screen space 

SYNOPSIS 

#mclude <pxm.h> 

float PMxat(scrn, i) 
PMsubscrn *scrn; 
short i; 

DESCRIPTION 

PMxat maps the subscreen coordinate i to the corresponding screen space jc. 

The mappings are: 

x=i N^-^Ox 

y ^j Ny+Oy 

where Nx and A^^ are the numbers of processors in the x and y directions, respectively, and Ox and Oy 
are the x and y offsets into the processor array, respectively. 

NOTES 

PMxat is implemented as a macro. 

SEE ALSO 

PMmyx(3X) 
PMmyyOX) 
PMyat(3X) 
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PMyat ( 3X ) DE Vtools PMyat ( 3X ) 



NAME 

PMyat - map subscreen coordinates to screen space 

SYNOPSIS 

#include <pxm.h> 

float PMyat(scrn, j) 
FMsubscrn *scrn; 
short j; 

DESCRIPTION 

PMyat maps the subscreen coordinate j to the corresponding screen space y . 

The mappings are: 

x=i N^ + 0^ 

y =j Ny-^Oy 

where Nx and Ny are the numbers of processors in the x and y directions, respectively, and Ox and Oy 
are the x and y offsets into the processor array, respectively. 

NOTES 

PMyat is implemented as a macro. 

SEE ALSO 

PMmyx(3X) 
PMmyy(3X) 
PMxat(3X) 
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NAME 

PMzaddr - generate a ZRAM pointer to a row 

SYNOPSIS 

#include <pxm.h> 

float *PMzaddr(i, j) 
int i, j; 

DESCRIPTION 

PMzaddrO loads a page register with an appropriate descriptor, and then constructs a valid pointer that 
references that page register. 

PMzaddr returns a pointer to the z value on the given row (i,j). Because the page register is loaded in 
fixed row addressing mode, the pointer can be used directly up to the end of the given row. To generate 
a column mode address use PMzaddrcoI(). 

i and j are coordinates in the range [0, 255]. Values outside this range will generate unpredictable 
results. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

PMzaddrO does not consider the PMsubscrn structure. 

The pointer returned by this function can be cast to allow access to char, int, or other types of data 
stored in Z memory. 

SEE ALSO 

PMgetzbuf(3X) 

PMzaddrcol(3X) 

PMqzput(3X) 

PMqzget(3X) 
PMv0get(3X) 
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NAME 

PMzaddrcol - generate a ZRAM pointer to a column 

SYNOPSIS 

#include <pxm.h> 

float *PMzaddrcol(i, j) 
int i, j; 

DESCRIPTION 

PMzaddrcolQ loads a page register with an appropriate descriptor, and then constructs a valid pointer 
that references that page register. 

PMzaddrcolO returns a pointer to the z value on the given row (ij). Because the page register is 
loaded in fixed column addressing mode, the pointer can be used directly up to the end of the given 
column. To generate a row mode address use PMzaddr(). 

i and j are coordinates in the range [0, 255]. Values outside this range will generate unpredictable 
results. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

PMzaddrcolO does not consider the PMsubscrn structure. 

The pointer returned by this function can be cast to allow access to char, int, or other types of data 
stored in Z memory. 

SEE ALSO 

PMgetzbuf(3X) 

PMzaddr(3X) 

PMqzput(3X) 

PMqzget(3X) 

PMv0get(3X) 
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NAME 

PMzbrk, PMblockreg, PMavail reg, PMset lowreg, PMset hireg - reserve DRAM and page regis- 
ters for dynamic allocation 

SYNOPSIS 

#include <pxm.h> 

PMzdesc PMzbrk(numblocks) 
int numblocks; 



#include <pageregs.h> 

PMblock_reg(n) 
int n; 

PMavail_reg(n) 
int n; 

PMset_lowreg(n) 
int n; 

PMset_hireg(n) 
int n; 

DESCRIPTION 

PMzbrk is the initialization call to create a list of memory resources for DRAM (also called ZRAM) 
that are used in subsequent calls to PMgetzaddrQ, PMgetzdescQ and PMfreezaddrQ. numblocks is the 
number of kilobytes (or rows) of DRAM to reserve and is in the range of 1 to 256 inclusive. The 
memory is reserved from the end of DRAM. For example, PMzbrk( 2 ) reserves the last 2 rows of 
DRAM, rows 254 and 255. 

The macros PMblock_reg(), PMavailregO, PMsetlowregO and PMset_hireg(), defined in 
pageregsX are provided as a way of manipulating the list of page registers that are made available to 
access DRAM through calls to PMgetzaddr(). By default PMzbrk makes the page registers in the 
range to 13 inclusive, available. These macros only have an affect when called after PMzbrk. 

PMblock_reg() and PMavail_reg() are used to specify individual page registers to be excluded or 
included, respectively, from use by PMgetzaddr. 

Another way to specify the page registers is to provide a range with calls to PMsetlowregO and 
PMs€t_hiregO. The range is inclusive. For example, the calls 

PMset Jowreg( 10 ) 
PMset_hireg( 13 ) 

indicate that the page registers 10, 11, 12 and 13 can be used by PMgetzaddr(). The low and high 
registers can be set in the range from to 13, inclusive. Page registers 14 and 15 are reserved for use 
by the host. 

It is necessary to block certain page registers to avoid conflicts when using other DEVtools functions 
such as PMgetpix, that use page registers internally. If a page register is no longer needed by a specific 
routine later on, it could be made available to PMgetzaddr with a call to PMavail_reg(). 
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Register assignments are given in the following table. 



Page Register Assignments 


Page Register 


Function 





PMgetscanO, PMputscanQ, PMclearQ, PMgetcol(), PMputcol(), 




PMgetrowO, PMputrow() 


1 


PMgetscanO, PMputscanQ, PMclearQ, PMgetcolQ, PMputcolQ, 




PMgetrowQ, PMputrowQ 


2 


PMvOgetQ, PMgetpixQ, PMgetcolQ, PMputcolQ, PMgetrowQ, PMputrowQ 


3 


PMvOgetQ, PMgetpixQ, PMgetcolQ, PMputcolQ, PMgetrowQ, PMputrowQ 


4 


PMvOputQ, PMputpixQ 


5 


PMvOputQ, PMputpixQ 


6 


PMvlgetQ 


7 


PMvlgetQ 


8 


PMvlputQ 


9 


PMvlputQ 


10 


PMpixaddrQ 


11 


PMpixaddrQ 


12 


PMzgetQ, PMgetzbufQ, PMzaddrQ 


13 


PMzputQ, PMputzbufQ, PMzaddrcolQ 


14 


Reserved for host use 


15 


Reserved for host use 



NOTES 



Requesting a number of blocks greater than 256 can cause PMgetzdescQ to fail in unpredictable ways. 

SEE ALSO 

PMgetzaddr(3X) 
PMgetzdesc(3X) 
PMfreezaddr(3X) 



Pixel Machines 



Last change: Version 1.1 



PMzget ( 3X ) DEVtools PMzget ( 3X ) 



NAME 

PMzget - read a float from the z buffer 

SYNOPSIS 

#include <pxm.h> 

float *PMzget(i, j, zptr) 
short i, j; 
float *zptr; 

DESCRIPTION 

PMzgetO reads a single z value from the Z buffer. Unlike PMgetzbufO, the coordinate system used 
allows fiill access to z buffer memory. 

/ and j are coordinates in the range [0, 255]. Values outside this range will generate unpredictable 
results. 

zptr is a pointer to a floating point variable that will be written with the z value contained at (/,/) in the 
z buffer. 

PMzgetO returns a pointer to the next z value on the given row (Z+lj*). This pointer can be used by 
PMqzgetO for more efficient frame buffer access. For even faster access, the pointer returned can be 
used directly (unlike the pointer returned from PMvOgetO) because z buffer memory is fully mapped. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

PMzgetO does not consider subscreens. 

The pointer returned by this function can be cast to allow access to char^ inu or other types of data 
stored in Z memory. 

SEE ALSO 

PMgetzbuf(3X) 
PMqzget(3X) 

PMv0get(3X) 
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NAME 

PMzput - write a float to the Z-buffer 

SYNOPSIS 

#mclude <pxm.h> 

float *PMzput(i, j, zval) 
short i,j; 
float zval; 

DESCRIPTION 

PMzput writes a single Z value to the Z buffer. Unlike PMputzbuf, the coordinate system used allows 
full access to Z buffer memory. 

i and j are coordinates in the range [0, 255]. Values outside this range will generate unpredictable 
results. 

zval is the floating point value to be written at (i,J) in the Z buffer. 

PMzput returns a pointer to the next pixel on the given row O+lj). This pointer may be used by 
PMqzput for more efficient frame buffer access. 

For even faster access the pointer returned can be used directly (unlike the pointer returned from 
PMvOput), since Z buffer memory is fully mapped. 

NOTES 

Refer to PMzbrk(3X) for page register use. 

PMzput does not consider subscreens. 

The pointer returned by this function can be cast to allow access to char, inu or other types of data 
stored in Z memory. 

SEE ALSO 

PMputpix(3X) 

PMqzput(3X) 

PMv0put(3X) 
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NAME 

printf - formatted output conversion on host 

SYNOPSIS 

void printf(format [, arg ] ...) 
char *format; 

DESCRIPTION 

printf does formatted output in the same way as the UNIX system library printf. The full range of 
flags, widths, precisions, and format specifiers of the UNIX system printf is allowed. The actual print- 
ing is done by a host program calling DEVpoUnodes, for example devprint, and is displayed on what- 
ever device that process was invoked on. 

It is possible to print a floating point number stored in host (IEEE) format with the new modifier, /, that 
is used in the same way as the / modifier of the UNIX system printf. However, because the DSP C 
compiler generates DSP DA move instructions that can destroy bits when passing an IEEE float to 
printf, the compiler must be fooled into thinking the float is a different data type of the appropriate size 
that will be passed with a bitwise copy. For example, to print a single host float: 

printf("%if", *(long *)&hostJloat); 

This technique must also be used whenever a float variable that is going to be passed to a function con- 
tains data that is not in DSP float format. 

A new format specifier %b is also allowed. It formats the argument as an unsigned binary short 
integer. If %lb is specified, a 32-bit argument is assumed. 

printf sends a system message and its arguments to the host and then returns. Some time later the host 
processes the format string and reads any pointer data from the nodes via DMA. The node program 
must therefore be careful not to modify any of the data or page registers associated with pointers in the 
printf argument list. To accomplish this PMwaitsem can be called right after printf to cause the node 
to wait until after the host has completely finished its printf processing. 

NOTES 

Up to 10 arguments of any scalar type may be given to printf. Using more than 10 arguments causes 
undefined behavior. 

Because ints are 16-bits on the DSP32 and 32-bits on the host, the 1 modifier must be used when a 32- 
bit integer quantity is to be printed; for example, to print a float in hex format: 

printf("%#IX", f); 

SEE ALSO 

devprint(l) 
PMwaitsem(3N) 
DEVpolI_nodes(3H) 
printfO on host system 
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NAME 



DEVimage_header - format of a DEVtools image file. 



SYNOPSIS 




#inciude <devimage.h> 




typedef struct 

{ 

unsigned long 




magic; 


unsigned long 


optionalheadersize; 


unsigned long 


imageformat; 


unsigned long 


pixelsize; 


unsigned long 


storagemode; 


unsigned long 


pixelsperline; 


unsigned long 


numberoflines; 


unsigned long 


xoffset; 


unsigned long 


yoffset; 


} DEVimageheader; 





/* magic number to indicate format */ 

/* size of optional header */ 

/* how the pixels are stored */ 

/* number of bytes per pixel */ 

/* order of pixels in the file */ 

/* number of pixels per scan line */ 

/* number of scan lines */ 

/* initial X value */ 

/* initial Y value */ 



DESCRIPTION 

The DEVimageheader structure precedes all data in an image file and specifies information necessary 
to correctly display the image. DEVimageheader contains only a minimum amount of information 
about the image. It is assumed that the optional header that follows DEVimageheader will contain 
more specific information on the file's contents if necessary. 

For portability reasons, each member of the structure is stored in the image file as an array of 8 decimal 
ACSII characters. The two routines DEVgetimageheader and DEVputimageheader should be 
used to read/write and convert the image header from/to ASCII. Each of the members of the structure 
are explained in detail below. 

The magic member of the structure contains a **magic number" indicating whether this file is in 
DEVtools image format or not. A value of DEVJMAGEMAGIC indicates that the file is in DEVtools 
image format, other values indicate that the format is not DEVtools image format. 

The optional Jieader size member gives the size of the optional header in bytes. The optional header is 
placed directly after the image header in the file. If the optional header is not present, diis field is 0. 

The imageformat field tells how the pixel information is stored in the image file. VaUd formats are: 



#define DEV^ 
#define DEV 
#define DEVj 
#define DEV_ 
#define DEV_ 
#define DEV_ 
#define DEV_ 
#define DEV_ 
#define DEV_ 
#define DEV_ 
#define DEV_ 
#define DEV_ 
#define DEV_ 
#define DEV 
#define DEV' 



USER_DEFINED 
RGBA_PACKED_PIXELS 
RGBPACKEDPIXELS 
MONO_PIXELS 
MONO__R_PIXELS 
MONO_G_PIXELS 
MONO_B_PIXELS 
MONO_A_PIXELS 
M0N0J6_PIXELS 
DSP_FLOAT_PIXELS 
IEEE_FLOAT_PIXELS 
RGBPACKEDPIXELS 
RGBA PACKED PIXELS 



/* user defined Image type */ 

/* RGBA order, 4 bytes per pixel */ 

/* RGB order, 3 bytes per pixel */ 
/* one byte per pixel */ 
/* one red byte per pixel */ 
/* one green byte per pixel */ 
/* one blue byte per pixel */ 
/* one alpha byte per pixel */ 
/* 16 bit pixels */ 

/* 32 bit DSP floating point pixels */ 
/* 32 bit IEEE floating point pixels */ 
/* unpacked (16 bit components) RGB pixels */ 



/* unpacked (16 bit components) RGBA pixels */ 
RGB_PACKED_ENCODED_PIXELS /* run-length encoded RBG pixels */ 

ABGR_PACKED_PIXELS /* packed ABGR pixels */ 



Pixp.l M^rhinps 



T.^<;t rhantrp- Vp.r<;inn 1 1 
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c 

#define DEV_RGB_^ENCODED_PIXELS /* unpacked, run-length encoded RGB pixels */ ^ 

The pixel_size field contains the number of bytes that make up a single pixel. 

The storage jnode indicates the order in which the pixels are stored in the image. Valid values for 
storagejnode are: 

DEV_ROW_MAJOR - pixels are stored by rows, that is in the order (0,0), (1,0), (2,0),...,(0,1), (1,1), 

DEV_COLUMN_MAJOR - pixels are stored by columns, that is in the order (0,0), (0,1), 
(0,2),...,(1,0), (1,1), ... 

The pixels j)erjine member indicates the number of pixels per scan line (width) for this image. 

The number j)f Jims field indicates how many scan lines (height) are contained in this image. 

The x_offset field stores the X value of the initial pixel. 

The yyjfset field stores the Y value of the initial pixel. 

SEE ALSO 

DEVget_image_header(3S) 

DEVputimageheaderOS) 

devsave(l) 

devdisp(l) ^ 

picsave(l) V 

picdisp(l) 

raydisp(l) 

raysave(l) 



c 
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NAME 

PMcommand - data structure used for FIFO commands 

SYNOPSIS 

#include <pxm.h> 

typedef struct { 

short opcode; 

short count; 

float *data_ptr; 
} PMcmdtype; 

extern PMcmdtype PMcommand; 

DESCRIPTION 

Host programs usually operate on the Pixel Machine by sending data packets to the pipe nodes through 
the FIFOs. The pipe nodes may modify, delete, or pass on the command packets unmodified, or they 
may also generate new packets. The format of these data packets (called commands) is: 

OPCODE COUNT PARAM, ...PARAM 

1 count 

where OPCODE and COUNT are 16-bit values, and each of the parameters in 

PARAM , . . . PARAM 

1 count 

is a 32-bit value. 

The global data structure, PMcommand, defined in both the pipe and pixel nodes, reflects this packet 
structure. The members of this structure contain the following: 

PMcommand.opcode: contains the opcode 

PMcommand.count: contains the negated count of the number of bytes in the parameter list 

PMcommand. data_ptr: points to a static buffer containing the parameters. It may be changed 
to point to a user-defined buffer. 

Pipe node programs read a command from the input FIFO in two steps: 

call PMgetop to load an opcode and count from the input FIFO 

if parameter count is nonzero, call PMgetdata to load parameters from the input FIFO. 

Pixel nodes read a command by calling PMgetcmd, which loads all three components of the command. 

Pipe node programs may write a command to the output FIFO in two ways. First, by calling PMputop 
followed (if count is nonzero) by a call to PMputdata. Secondly, by calling PMputcmd, which com- 
bines the functionality of PMputop and PMputdata. 

By changing members of the PMcommand structure, a pipe node program may modify the command 
stream as needed. 

Pixel node programs read commands from the last pipe node but cannot write commands. 

SEE ALSO 

DEVwrite(3H) 
PMgetcmd(3X) 
PMgetdata(3P) 
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PMgetop(3P) 
PMputcmd(3P) 
PMputdata(3P) 
PMputop(3P) 
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NAME 

DEVpiperead - reads a block of memory from a pipe DSP 

SYNOPSIS 

#include <host/devtools.h> 

int DEVpipe_read(pixel_system, node, addr, buffer, nbytes) 

DEVpixelsystem *pkel_system; 

int node; 

DEVushort addr; 

DEVbyte *buffer; 

int nbytes; 

DESCRIPTION 

DEVpipe_read reads a block of memory from a pipe DSP. The data is retrieved from DSP memory 
using parallel DMA. 

pixel_system is a pointer to the system descriptor, node is the number of the pipe node from which the 
data is to be read, addr is the location in the DSP address space that contains the data is be read. 
buffer points to the location into which the data is to be read, nbytes is the number of bytes of data to 
be read, nbytes should always be an even number. If nbytes is odd, nbytes+l bytes of data will be read. 

No byte order translation is performed. The data read will be in the same byte order as it is in the DSP 
memory. 

DEVpipe_read uses parallel DMA I/O to transfer the data. As a result, the parallel control register is 
updated by this routine. The parallel communications modes are altered to: 

enable DMA 

set PAR to be autoincremented on DMA 

set the interrupt vector to 16-bit mode 

DEVpipe_read should always return zero. 

NOTES 

If nbytes is odd, DEVpipe^read will read nbytes+l bytes of data and return -1 as its return value. The 
return value should be the number of bytes written, not zero. 
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NAME 

DEVieee_dsp - convert from the host's floating-point format to the DSP32 floating point format 

SYNOPSIS 

#include <host/devtools.h> 

DEVulong 
DEVieee_dsp(f) 
double f; 

DESCRIPTION 

The host and the DSP32 use different formats for floating point numbers. DEVieeedsp converts a sin- 
gle floating point number in the IEEE format used by the host to a 32 bit floating point number in 
DSP32 format The number to be converted is stored in/. 

The value returned by DEVieee_dsp must be converted to the correct Pixel Machine byte order. This is 
done implicitly when the value is written to the pipe, but it must de done explicitly using DEVbswaplQ 
or DEVswapJongO if the value is sent to the Pixel Machine in some other way (e.g., via DMA). 

RETURNS 

DEViee€_dsp returns a 32 bit number in the DSP32 floating point format. 

NOTES 

DSP floating point values should always be treated as unsigned long values on the host to prevent the 
compiler from performing undesired type- casting; for example, promotion to double when used as a 
function argument. 

SEE ALSO 

DEVdspjeee(3S) 
DEVbswapI(3S) 
DEVswapJong(3S) 
DEVswap_short(3S) 
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